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Questo approfondimento tematico e pensato per chi 
vuol imparare a programmare e creare software per 
I 'Apple iPhone. 

La prima parte del testo guida il lettore alia cono- 
scenza degli strumenti necessari per sviluppare sulla 
piattaforma mobile di Cupertino. 
Le sezioni successive sono pensate per un apprendi- 
mento pratico basato su esempi di progetto: la crea- 
zione di un browser su misura, la gestione dell'inter- 
faccia, la programmazione di un' agenda e di una to 
do list, la gestione corretta di celle e tabelle, I'utilizzo 
dell'accelerometro, la progettazione di un RSS reader 
e via dicendo. 

Una serie di esempi pratici da seguire passo passo 
che - creando applicazioni testabili e perfettamente 
funzionanti - spingono il lettore a sperimentare sul 
campo il proprio livello di apprendimento e lo invita- 
no a imparare divertendosi. 
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Inizia da questo numero un corso dedicato alio sviluppo 
dell'apple iphone, lo smartphone che ha rivoluzionato il 
mondo mobile, in questo primo appuntamento faremo 
la conoscenza di tutti gli strumenti necessari 

APPLE IPHONE 

PROGRAMMING 11 

Continuiamo il corso inerente la programmazione del 
dispositivo smartphone apple iphone, illustrando gli 
strumenti necessari per completare I'applicazione mini 
browser avviata nel numero precedente della rivista 

LA NOSTRA APP 

E SULL'APPLE STORE (2) 11 

pubblicare un'applicazione su apple store adoperando 

i portali iphone provisioning portal e itunes connect: 

scopriamo come farlo al meglio, 

seguendo tutto il percorso che arriva fino alia pubbli- 

cazione 
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In questa terza lezione modifichiamo il minibrowser 
introdotto nel precedente articolo della serie, intro- 
ducendo altri concetti fondamentali come la gestio- 
ne degli aspetti grafici e I'utilizzo del componente 
uiwebview 

REALIZZIAMO UNA 

AGENDA PER IPHONE 23 

Da questo numero inizia una trattazione che e un po' 
il cuore di quasi ogni applicazione iphone. stiamo 
parlando delle tabelle. vedremo come si creano, quali 
tipologie utilizzare a seconda del contesto, e come 
gestirle al meglio 

IPHONE: GESTIONE 

DELLA MEMORIA 29 

Per chi si accinge a sviluppare applicazioni per lo smar- 
tphone di casa apple, uno degli argomenti sicuramente 
piu ostici, e la gestione della memoria. In questo artico- 
lo affronteremo proprio questa importante tematica 

LEAK E ZOMBIE 

IN AGGUATO 35 

In questo articolo approfondiremo ulteriormente i 
concetti legati alia gestione della memoria, in modo 
particolare faremo la conoscenza di quelli 
che in gergo vengono chiamati zombie e leaks 



i COME POPOLARE 

I UNA UITABLEVIEW 20 

In questo articolo popoliamo la nostra tabella con un 
elenco di voci ottenute interrogando una serie di strut- 
ture dati. nella fattispecie vedremo 
come inserire delle semplici righe, creare delle sezioni e 
navigare tra le stesse 

| GESTIONE DELLE 

I CELLE NELLE TABELLE 47 

In questo articolo trattiamo delle varie funzionalita 
offerte dall'SDK per inserire e cancellare una o piu righe 
nelle tabelle: elemento fondamentale nella costruzione 
delle interfacce, sia per I'input che per la visualizzazio- 
ne dei dati 

UNA SVEGLIA 

DIGITALE PER IPHONE 53 

In questo articolo mostriamo come realizzare una 
sveglia digitale che ci avvisera di impegni e scadenze 
imminenti. sara I'occasione di approfondire i concetti 
legati alia gestione dell'interfaccia e del timer 

I UN ACCELEROMETRO 

I PER AMICO 59 

L'accelerometro presente nell'iphone e uno dei com- 
ponenti piu efficaci nel consentire all'utente un'intera- 
zione con giochi e applicativi maggiormente semplice 
e intuitiva. vediamo come integrarlo nelle nostre appli- 
cazioni 

I IPHONE: GESTIRE 

I IL MULTI-TOUCH 63 

Lo schermo multitouch consente di interagire con un 
dispositivo senza la necessita di fornire ingombranti 
tastiere. impariamo a intercettare le azioni degli utenti 
e a gestirle in modo da non far rimpiangere tastiera e 
mouse 

I UN RSS READER SU IPHONE 68 

Distribuire informazioni attraverso le nostre applicazioni 
puo essere molto piu semplice adoperando la classe 
nsxmlparser. saremo cos] in grado di raccogliere e 
mostrare i contenuti degli rss consumando pochissima 
banda 

I UN RSS READER PER IPHONE 73 

Adoperando la classe nsxmlparser, possiamo intera- 
gire con i contenuti di un feed rss. in questo articolo 
mostreremo come fare e come implementare una strut- 
tura dati per la visualizzazione delle info ricevute 



^PuntotoformaticD I [j^j 



iPhone programming T 



Imparare a programmare I'Apple iPhone 



CREARE SOFTWARE 
PER L'APPLE IPHONE 

INIZIA DA QUESTO NUMERO UN CORSO DEDICATO ALLO SVILUPPO DELL' APPLE IPHONE, 
LO SMARTPHONE CHE HA RIVOLUZIONATO IL MONDO MOBILE. IN QUESTO PRIMO 
APPUNTAMENTO FAREMO LA CONOSCENZA Dl TUTTI GLI STRUMENTI NECESSARI 
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A causa della NDA (Non Disclosure 
Agreement) che nel mese di luglio dello 
scrso anno ha accompagnato la distribu- 
zione dell' SDK, parallelamente all'uscita in Italia 
dell'iPhone, non ci e stato possibile pubblicare i 
successivi articoli pianificati per il seguente 
corso di programmazione di questo interessante 
dispositivo. Negli ultimi mesi sono state apporta- 
te numerose migliorie al firmware (terminate 
con il rilascio della versione stabile 2.2.1), e 
recentemente l'OS 3.0 con il relativo SDK 3.0, (in 
fase di beta 3 al momento della scrittura di que- 
sto articolo), fornira ancora piu strumenti per i 
programmatori che desiderano utilizzare al 
meglio le funzionalita di questa piattaforma di 
sviluppo. Molti concetti fondamentali, tra cui 
architettura dell'iPhone, su come e strutturato il 
framework, la disposizione delle cartelle dei pro- 
getti creati con Xcode, inclusi numerosi consigli 
di ottimizzazione, sono stati gia affrontati nel 
numero 130 di questa rivista. Consigliamo a que- 
sto proposito di ridare una lettura a tali pagine, 
perche non verranno trattati, se non quando sara 
strettamente necessario. Ricordiamo, inoltre, che 
e possibile realizzare un software completamen- 
te funzionante senza avere acquistato alcun 
iPhone o iPod Touch di seconda generazione, e 
senza acquistare la licenza. Di contro, si devono 
accettare le seguenti limitazioni: in alcune situa- 
zioni tale software, eseguito all'interno dell'emu- 
latore, non si comportera in maniera fedele al 
vero dispositivo, quello fisico, rendendo addirit- 
tura inutilizzabile il vostro prodotto. Questo e 
dovuto sia al fatto che l'emulatore suddetto viene 
eseguito utilizzando le risorse hardware (netta- 
mente piu prestanti sotto ogni aspetto) del 
vostro computer, sia perche manca di alcune 
funzionalita, come il GPS e l'accelerometro ad 
esempio, sia per alcune discrepanze che molti 
programmatori hanno riscontrato nei vari test; 
se non acquisterete una licenza non potrete 
testarlo su alcun iPhone/iPod e non potrete ven- 
derlo sull'Apple Store. La scelta se utilizzare un 



iPhone o un iPod Touch spetta a voi, un iPod 
Touch di seconda generazione e comunque vali- 
do, poiche ha un hardware leggermente piu pre- 
stante rispetto al "fratello", manca pero delle fun- 
zionalita GPS, UMTS e fotocamera; come detto 
precedentemente lo sblocco del Bluetooth con il 
firmware 3.0 nell'iPod Touch ha eliminato questa 
ulteriore differenza tra i due dispositivi. 



REGISTRAZIONE E SDK 

Per iniziare a programmare e necessario effettua- 
re due operazioni: la prima consiste nel registrar- 
si come sviluppatore, divenire quindi Registered 
iPhone Developer, operazione completamente 
gratuita. Bastera accedere al seguente indirizzo 
http://developer.apple.com/iphone/ 
cliccare poi sulla voce in alto, register, e decidere 
se creare un nuovo account, oppure, nel caso vi 
siate gia registrati utilizzando mobileMe, Yitunes 
Store, YADC (Apple Developer Connection) o Apple 
Online Store, utilizzare il vostro identificativo cor- 
rente. A questo punto e necessario inserire tutte 
le informazioni anagrafiche, accettare 
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Fig. 1: La home page del sottosito dedicato alio svilup- 
po di applicazioni per iPhone 
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Figf. 2: La fase di registrazione, in cui sono richieste 
tutte le vostre infotmazioni anagrafiche 



1'informativa e, alia ricezione dell'email di con- 
ferma, seguire il link che vi verra inviato: siete 
co si divenuti Registered iPhone Developer. 
La seconda, ed ultima, operazione da effettuare, 
consiste nello scaricare e installare sul vostro 
Mac l'SDK; la versione stabile, 2.2.1, consiste in 
un file di circa 1.7GB, consigliamo quindi di uti- 
lizzare una connessione relativamente veloce; e 
inoltre necessario avere almeno Leopard aggior- 
nato alia versione 10.5.4 e disporre di sufficiente 
spazio sul proprio disco, poiche, inclusa la docu- 
mentazione, verranno occupati oltre 5GB. 
All'awio dell' installer sara richiesto quali com- 
ponenti installare: quelli di default sono suffi- 
cient. Al termine di questo non breve processo le 
librerie, tutto il software necessario, tra cui il 
simulatore, Xcode, 1' editor per i progetti, 
Interface Builder, 1' editor WYSIWYG, Shark e 
Instruments, necessari per il tuning delle vostre 
applicazioni, compresa una versione parziale 
della documentazione saranno contenuti all'in- 
terno della cartella Developer. All'interno della 
cartella Applications trovano posto quegli stru- 
menti che adopererete in ogni progetto: XCode, 
Interface Builder, Shark (sottocartella Perfor 
mance Tools) e Instruments; poiche da Xcode e 
possibile richiamare tutti gli altri applicativi, 
bastera trascinare solo tale software nel Dock per 
avere disponibile tutti questi programmi con un 
colpo di clic. La documentazione non viene 
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Fig. 3: La struttura della cartella di installazione 
dell'SDK 



installata completamente, e si ha libera scelta se 
consultarla richiamando le pagine disponibili 
online, prelevate automaticamente quando 
necessario, risparmiando spazio sul proprio HD, 
o scaricarla localmente; in questo ultimo caso, 
sara necessario awiare XCode, selezionare il 
menu Help->Documentation e cliccare sui singoli 
tasti get che si trovano vicino alle singole catego- 
rie; sono inoltre disponibili documenti riguar- 
danti la libreria WebObjects (bisogna selezionarla 
tra i componenti aggiuntivi durante la fase di 
installazione) e le API Java 1.4 e 1.5, questo per- 
che la versione di Xcode (e degli altri software 
installati) consente anche di realizzare applicati- 
vi, plugin, moduli aggiuntivi per Mac OS in Java, 
C++, Ruby e altri linguaggi. La versione 2.2.1 non 
e dotata di documentazione, poiche e stata rila- 
sciata per correggere alcuni bug, non e quindi 
awenuta alcuna modifica all 'API, per tale motivo 
la documentazione piu aggiornata corrisponde a 
quella fornita con la 2.2. Utilizzando il campo di 
testo presente in alto a destra, si ricercheranno 
quelle funzioni e/o metodi disponibili per una 
consultazione; e possibile inoltre filtrare su quale 
API effettuare la ricerca. 



IMIZIAMO L'AWENTURA 

In questa prima puntata creeremo un browser 
web minimale che ci permettera di conoscere i 
concetti fondamentali di questa tecnologia, pro- 
gressivamente presenteremo le nozioni necessa- 
rie per completare il progetto e renderlo piena- 
mente operativo; non creeremo nuove classi per 
evitare confusione, ma utilizzeremo quelle for- 
nite quando si crea un nuovo software usando il 
wizard; ricordiamo che la struttura delle classi 
con cui lavoreremo e organizzata con una strut- 
tura ad albero (Fig.2), avente una radice 
(NSObject al piu alto livello, UlWindow scenden- 
do di qualche gradino) a cui si associano i vari 



RIFERIMENTI WEB 

Per la creazione 
dell'account e per 
scaricare l'SDK, visitate il 
seguente percorso web: 
http://developer.apple.co 
m/iphone/ 



All'indirizzo che segue 
trovate una descrizione 
dettagliata delle novita 
fornite con il nuovo SDK 
3.0: 

http://developer.apple.co 
m/i phone/prerelease/libra 
ry/releasenotes/General/W 
hatsNewlniPhoneOS/ArticI 
es/i PhoneOSv3.htm I 
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DESIGN PATTERN 
MVC 

Model-View-Controller 
(MVC, talvolta tradotto in 
italiano Modello-Vista- 
Controllore) e un pattern 
architetturale molto diffuso 
nello sviluppo di interfacce 
grafiche di sistemi 
software object-oriented. 
Viene sovente utilizzato da 
framework basati su Ruby, 
Java (Swing, JSF e Struts), 
su Objective C o su .NET. 
II pattern e basato sulla 
separazione dei compiti fra 
i componenti software che 
interpretano tre ruoli 
principali: 

- il model fornisce i 
metodi per accedere ai dati 
utili all'applicazione; 

- il view visualizza i dati 
contenuti nel model e si 
occupa dell'interazione con 
utenti eagenti; 

- il controller riceve i 
comandi dell'utente (in 
genere attraverso il view) e 
li attua modificando lo 
stato degli altri due 
componenti 




cfilkM Ki d*M ha* a drflenmt {Hue n Hw Iua ttckf 

Fig. 4: La struttura ad albero dell 'API 



UlView Controller (contenitori invisibili UIVJEW) 
e i cui figli sono discendenti della classe UlView 
(bottoni, testi e altri componenti). 
L'approccio migliore per iniziare a programmare 
1' iPhone /iPod Touch e quello top-down, adope- 
rando quei componenti dell'interfaccia grafica 
predefiniti, disponibili attraverso l'lnterface 
Builder (IB), aggiungendo, quando necessario, il 
codice minimale richiesto per ottenere il risulta- 
to desiderato. Successivamente si potra, nel caso 

10 si trovasse limitante oppure per semplici gusti 
personali, abbandonare completamente tale 
strumento visuale, e realizzare tutto in puro 
Objective- C. Riprendiamo brevemente il discor- 
so, iniziato nell'articolo di presentazione 
sull'iPhone, pubblicato a settembre e riguardan- 
te il design pattern MVC; dovrete metabolizzare 
tale concetto per non riscontrare problemi nella 
fase di sviluppo del vostro primo progetto. MVC 
e acronimo di Model View Controller, indica i tre 
componenti utilizzati per realizzare applicazioni 
in grado di adattarsi meglio a variazioni della 
propria struttura interna; con Model si indica 
la/le struttura/ e dati utilizzata/e per gestire le 
informazioni necessarie per un corretto funzio- 
namento del vostro software, possono essere 
variabili, array, strutture piu complesse, file loca- 

11 o remoti e anche database; con View (che non 
a caso viene identificata con la classe UlView) si 
indica l'interfaccia grafica necessaria per con- 
sentire all'utente finale una consultazione e/o 



interazione con tali dati; lo strumento per realiz- 
zarle e Interface Builder (utilizzando i file xib) 
oppure puro codice Objectice-C (creando tutte le 
strutture grafiche aH'interno di file .m/.h); con 
Controller intendiamo quella parte di codice 
necessaria per una corretta comunicazione tra le 
due strutture precedenti: e, di fatto, la compo- 
nente in cui risiede 'Tintelligenza" del vostro 
software (e dove owiamente riscontrerete la 
quasi totalita dei problemi e degli errori), prowe- 
dendo a creare un mapping tra cosa devono 
mostrate i vari componenti grafici e in che mo do 
devono essere modificati conseguentemente a 
un'interazione da parte dell'utilizzatore del 
vostro software; in questo contesto il Controller 
(anche qui non a caso identificato con la classe 
UrViewController) corrisponde al codice presen- 
te nei file .m/.h, realizzati con il linguaggio 
Objective-C (e possibile comunque inserire codi- 
ce C e C++ nel caso fosse necessario velocizzare 
alcune operazioni o per utilizzare le API a livello 
piu basso). 




CONTROLLER 



Objective-C 




Interface 
Builder 



Objective-C 



MODEL , 

vars/arrays/DB 



Fig. 5: Una generallzzazlone del design pattern MVC 
utilizzato 

CREAZIONE DEL 
PROGETTO E XCODE 

II progetto Xcode fornito dal Wizard, che ci con- 
sente di realizzare il nostro browser nella manie- 
ra piu veloce, utilizzando un'istanza di un 
UlViewController contenente una della classe 
UlView si chiama View-Based Application. 
Decidiamo il nome dell' applicative, e posizionia- 
molo in una cartella a nostra scelta. Al termine 
della creazione ci verra presentata la schermata 
di Fig.7. Analizziamola in breve: e suddivisa prin- 
cipalmente in tre aree: nella parte alta troviamo i 
comandi necessari compilare il nostro software, 
selezionare la piattaforma di testing, simulatore 
o dispositivo fisico (nel caso abbiate gia acqui- 
stato la licenza), nella colonna di sinistra trovia- 
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F/gf. 6: La finestra di scelta del progetto 



La cartella frameworks contiene le librerie che si 
desidera inserire nel progetto, le tre fondamentali, 
inserite automaticamente, sono UIKit.framework, 
Fondation.framework e Core Graphics.framework; 
per aggiungerne altre bastera trascinarle all'interno 
del progetto, oppure utilizzare il destro del mouse e 
selezionare Add Existing Frameworks. Le altre car- 
telle virtuali, rappresentate con differenti icone, 
svolgono principalmente funzione di raggruppa- 
mento automatico di diversi tipi di informazioni, 
errori di programmazione, file grafici xib, book- 
mark, ad esempio. Premendo CTRL + INVIO, oppu- 
re selezionando l'icona Build & Go, o dal menu 
Build la voce Build & Run awieremo il simulatore. 




mo tutti i file del progetto, comprese le librerie 
utilizzate, in quella destra viene visualizzato il 
contenuto del file selezionato a sinistra. 
Per aggiungere un file al nostro progetto e suffi- 
ciente crearlo utilizzando il menu File->Nuovo 
File, oppure ne trasciniamo uno preesistente all'in- 
terno della colonna di sinistra, prelevandolo da una 
finestra di Finder; e possibile utilizzare anche il 
comando Add to Project presente all'interno del 
menu Project, presentera una finestra da cui sele- 
zionare uno o piu file presenti nel proprio compu- 
ter: questa operazione e necessaria quando si crea- 
no risorse con software diversi come audio, video o 
immagini. Copiare tramite Finder un file all'inter- 
no della cartella del nostro progetto non e suffi- 
ciente, poiche XCode richiede che i file che dovra 
compilare vengano aggiunti utilizzando una delle 
modalita suddette: e quindi possibile inserire qua- 
lunque tipo di file nella cartella del progetto e 
aggiungere solo un sottoinsieme di tali elementi in 
XCode. Dopo aver selezionato il file ci verra presen- 
tata una finestra in cui potremo selezionare il 
checkbox corrispondente alia voce Copy items into 
destination group's folder (if needed) } tale operazio- 
ne non e obbligatoria, ma in caso non la si attivas- 
se non si copierebbe localmente, all'interno della 
cartella del progetto e si lavorerebbe con un link 
simbolico; una cancellazione o uno spostamento 
del file originale (quello flsico) dalla sua posizione 
(e situato in una diversa cartella del proprio com- 
puter) non permetterebbe di compilare il progetto; 
selezionando quindi tale opzione, abbiamo la 
garanzia di avere all'interno della cartella del pro- 
getto tutti i file necessari, rendendo estremamente 
veloce qualunque operazione di backup o invio ad 
ami sviluppatori. Analizziamo ora la finestra di 
sinistra. Noterete alcune cartelle, di colore giallo, 
queste non esistono flsicamente nel vostro compu- 
ter, si chiamano Group(s) e hanno lo scopo di con- 
sentire un raggruppamento visivo delle proprie 
risorse, sono delle cartelle virtuali, e possibile quin- 
di crearle liberamente utilizzando il tasto destro del 
mouse (Add->New Group) o dal menu Project. 



I FILE XIB E L'llMTERFACE 
BUILDER 

Ora che abbiamo creato un progetto, iniziamo a 
descrivere i due componenti fondamentali che 
sono onniprensenti nei progetti per iPhone, in 
maniera diretta e/o indiretta (utilizzando compo- 
nenti che da questi derivano): UlViewController e 
UlView. Ogni istanza di UlViewController e invisi- 
ble, e il suo scopo e quello di contenitore delle 
UlView (a cui appartengono tutti i componenti 
visuali, bottoni, testi inclusi) che in esso andremo a 
inserire, pub svolgere anche ruolo di gestore degli 
eventi, rafforzando ulteriormente il concetto di 
come nell'MVC il Controller sia "trasparente", non 
abbia quindi un aspetto graflco, ma sia puramente 
codice. Dopo avere creato il progetto troveremo 
due file xib all'interno della colonna di sinistra di 
XCode, un primo chiamato MainWindow.xib, il 
quale contiene la UlWindow, la root del nostro 
software, che prowede automaticamente a conte- 
nere e gestire tutte le sottoflnestre (e la catena di 
eventi), nel nostro caso sono un viewcontroller 
contenente una view, e un secondo file il cui nome, 
terminante per ViewContr oiler } dipendera da quel- 



INTERFACE 
BUILDER 

Interface Builder e 
un'applicazione facente 
parte di Xcode. Consente 
agli sviluppatori che usano 
Carbon e Cocoa di 
disegnare interfacce 
grafiche per le applicazioni 
usando uno strumento 
grafico, senza la neccessita 
scrivere nessuna riga di 
codice. L'interfaccia 
risultante e salvata in un 
file (abbreviazione di 
NeXT Interface Builder). 




Fig. 7: L'interfaccia di sviluppo ptoposta dal tool XCode 
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APPLE SDK 
IPHONE 3.0 

iPhone OS 3.0, la cui 
release ufficiale dovrebbe 
essere rilasciata in questi 
giorni, include un Software 
Developer Kit (SDK) 
aggiornato con oltre 1 000 
nuove Application 
Programming Interface 
(API) tra cui In-App 
Purchases, connessioni 
Peer-to-Peer, una 
interfaccia applicativa per 
gli accessori, accesso alia 
libreria musicale dell'iPod, 
un nuovo Map API e le 
notifiche Push. Saranno 
disponibili oltre 100 nuove 
funzioni per gli utilizzatori 
di iPhone e iPod touch, tra 
cui il Taglia, Copia e Incolla 
(che potranno essere 
utilizzate alllnterno etra le 
applicazioni), gli MMS 
(disponibili solo su iPhone 
3G) per spedire e ricevere 
immagini, contatti, file 
audio e posizioni 
geografiche con la funzione 
Messaggi, il Bluetooth 
stereo, la sincronizzazione 
delle note con Mac e PC; 
shake per attivare la 
funzione Shuffle, il 
controllo parentale per i 
programmi televisivi, i film 
e le applicazioni dell'App 
Store e il login automatico 
agli hot spot Wi-Fi. 
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Fig. 8: L' interfaccia di Interface Builder, il wizard che consente di "disegnare" la nostra applicazione 



lo del nostro progetto, nel nostro caso e ioPro 
grammoArt2Viewcontroller.xib; quest'ultimo file e 
quello che ci interessa e che andremo a modificare 
visivamente con Interface Builder. 
La nostra TJIView, al cui interno andremo a posizio- 
nare alcuni componenti visuali (pulsanti, testi, 
immagini), ha necessita di essere ospitata in un 
TJIViewController (o classe derivata) per essere 
mostrata su schermo, in questo caso tale operazio- 
ne e stata gestita automaticamente dal wizard, ma 
in altri casi e necessario creare tramite IB tale rela- 
zione, oppure adoperando Objective-C. In un pro- 
getto sviluppato con XCode e possibile creare un 
numero indeterminato di file xib, realizzati adope- 
rando Interface Builder, 1' editor WYSIWYG disponi- 
bile tra i software forniti nell'SDK; ogni file con 
estensione xib e in realta un semplice XML (per chi 
avesse utilizzato Adobe Flex e un approccio simile 
a quello dei file MXML, mentre per chi conosce 
Windows Presentation Foundation e simile, sem- 
pre concettualmente parlando, a quello ideato per 
i file XAML) che viene letto, interpretato e mostrato 
in maniera visuale da IB. Diamo uno sguardo velo- 
ce alia struttura di uno di questi file, premendo il 
destro del mouse selezioniamo la voce "Open as 
Souce Code File", otterremo il seguente codice (qui 
ridotto per la sua estrema lunghezza): 

<?xml version="1.0" encoding="UTF-8"?> 
orchive type="com. apple. InterfaceBuilder3. 

CocoaTouch.XIB" version = "7.02" > 

<data> 

<int key="IBDocument.SystemTarget">528</int> 
<string 

key="IBDocument.SystemVersion">9E17</string> 

<string key="IBDocument.InterfaceBuilder 

Version" >672</string> 



<string 

key="IBDocument.AppKitVersion">949.33</string> 

<object class="IBUIView" id = "774585933"> 

<string key="NSFrameSize">{320, 460}</string> 
<object class="NSColor" key="IBUIBackgroundColor"> 

<int key="NSColorSpace">l</int> 

< bytes key = " N S RG B" > MC44 M DQzN Dc4 

MSAwLjM5MzQ0OTI4IDAuMjk4MDAzOTcAA</bytes> 
</object> 



< reference key = "object" ref="774585933'7> 
<reference key="parent" ref="3609493477> 
<string key="objectName">ViewPrincipale</string> 



</data> 
</archive> 

Un file XML relativamente complesso, ma basta 
fare qualche test all'interno di IB per verificare in 
che modo questa struttura viene modificata; se 
notate, la riga <object class-" IBUIView" id-" 
774585933"> contiene al suo interno molte delle 
informazioni riguardanti la view che e stata creata 
automaticamente, ad esempio le dimensioni, il 
colore di sfondo e quali componenti vengono 
simulati visivamente (spiegheremo piu in avanti 
tale funzionalita); il numero ID viene usato in altre 
locazioni di tale file per riferimenti a questo stesso 
oggetto (come awiene in una delle ultime righe 
<reference key- "object" ref- "774585933 "I. 
Modificare direttamente tale file e inutile, poiche IB 
serve proprio a questo, inoltre si rischia di renderlo 
inutilizzabile, ma sapere almeno che e un formato 
leggibile da qualunque utente e non e codifica- 
to/compilato, pub risultare utile in alcuni casi, 
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come quando si corrompe per qualche motivo 
(crash di IB, del sistema operative o della locazio- 
ne fisica in cui viene memorizzato) e non si riesce 
piu a modificare una (o piu) proprieta di un (o piu) 
componente da IB. 

Questo formato viene automaticamente convertito 
in fase di compilazione in maniera trasparente. 
Cliccando invece due volte sul tale file awieremo 
automaticamente IB. 

Partendo da sinistra e andando verso destra abbia- 
mo: la finestra di anteprima, la Document Window 
e l'lnspector; la prima e responsabile della visualiz- 
zazione dell' anteprima dell'interfaccia grafica, 
mostrera quindi tutti i componenti grafici che inse- 
riremo con una semplice operazione di trascina- 
mento dalla finestra chiamata Library. La seconda 
finestra che incontriamo, la Document Window, 
mostra un elenco di tutti gli oggetti presenti nel file 
.xib, sia grafici che non, ci permette, inoltre, di sele- 
zionarli e poter cosi visualizzare i dettagli all'inter- 
no della finestra alia sua destra, l'lnspector; la chiu- 
sura della Document Window comporta la chiusu- 
ra di tutto il file xib in IB, rendendo quindi necessa- 
rio riaprire tale file dal menu File->Open o facendo 
nuovamente doppio clic in XCode. I tre componen- 
ti visibili nel Document Window inizialmente sono 
il file owner, il cui scopo e quello di identificare 
quale classe (la coppia .m/.h) e collegata al file .xib 
che stiamo usando (sotto la colonna type risulta 
ioProgrammoArt2ViewController, creata automati- 
camente dal wizard), first responderer utilizzato per 
gestire la catena di eventi, e la nostra View, che in 
questo caso non ha alcuna coppia di file .m/.h asso- 
ciata (basta notare che sotto la colonna Type risulta 
UlView invece di un nome di classe creato manual- 
mente dal sottoscritto). Le quattro sottofinestre 
dell' Inspector forniscono tutte le informazioni 
riguardanti un determinato componente selezio- 
nato. Cliccando sulla view, utilizzando il Document 
Window abbiamo ottenuto i seguenti risultati. 
Attributes Inspector: nella parte alta troviamo la 
sezione chiamata view simulated bar metrics, che 
permette di aggiungere solo visivamente alcuni 
componenti grafici, tipici di classi derivate da 
UlViewController piu complesse, come il Tab Bar 
Controller e il Navigation Controller, in modo da 
fornire un feeback visivo di come tale view cam- 
biera le proprie proporzioni all'interno dei conte- 
nitori; F anteprima non modifica in alcun modo la 
struttura effettiva della view, e un semplice stru- 
mento di valutazione. Nella parte bassa sono pre- 
senti opzioni come la trasparenza, il colore della 
view, come questa si adatta in funzione delle 
dimensioni settate, se consente l'interazione con 
l'utente, e altre funzioni specifiche a seconda della 
sottoclasse di UlView utilizzata (ad esempio, un 
UIButton, un semplice bottone, ha proprieta diver- 
se di un UILabel, il cui scopo e solo di visualizzare 
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Fig. 9: Come si identificano i componenti dell'MVC 
utilizzando un file XIB 



del testo); spiegheremo in dettaglio tutti questi 
campi nei prossimi articoli a seconda delle esigen- 
ze. Nel Connection Inspector avremo modo di 
visualizzare i collegamenti tra view e controller (ma 
non solo). Nella Size Inspector troviamo i tipici con- 
trolli di dimensionamento e allineamento. 
Nell'Identity Inspector trovano posto tutte le infor- 
mazioni riguardanti relazioni ed eventi gestiti dalla 
view, compresa la classe che la gestisce (si parlera 
di IBOutlet e IBAction). 

Come spiegato precedentemente, IB genera file 
che appartengono al componente del pattern MVC 
chiamato View, non e'e modo diretto di scrivere 
all'interno di questo editor codice Objective-C, per 
tale motivo dobbiamo creare una coppia di file per 
ogni componente grafico con il quale vogliamo che 
l'utente interagisca (sia derivato da 
UlViewController che da UiView), o che desideria- 
mo animare o trasformare in qualche modo, e 
associare in Interface Builder questa coppia di file 




ALTERNATIVE A 
MAC OSX E XCODE 

IBM ha rilasciato una 
propria guida alio sviluppo 
di applicazioni per iPhone, 
utilizzando come sistema 
operativo Windows o Linux. 
La guida si intitola Write 
native iPhone applications 
using Eclipse CDT. Si tratta 
di un PDF in lingua inglese 
che e possibile scaricare 
gratuitamente da questo 
indirizzo web: 

htt p://www. i bm .co m/d eve 
loperworks/edu/os-dw-os- 
ecl i pse-i phone-edt. htm I . 
Per lo sviluppo vengono 
utilizzati Eclipse e Cygwin, 
tuttavia, le applicazioni 
sviluppate secondo questo 
schema non possono 
essere pubblicate 
sull'AppStore, ma soltanto 
su sistemi come Cydiae 
Installer. 
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al componente visivo: i file in questione avranno 
estensione .h e .m, e rappresenteranno quindi il 
Controller del nostro componente (in questo pro- 
getto non diamo attenzione al Model). Questi due 
file sono complementari, e rappresentano 
un'unica classe realizzata con un linguaggio object 
oriented (categoria alia quale owiamente 
FObjective-C appartiene); con 1' estensione .h si 
indica l'interfaccia della classe, rappresenta quindi 
queH'insieme di metodi e variabili che si desidera 
rendere disponibili esternamente, alle altre classi e 
a Interface Builder. 

Ecco come si presenta l'interfaccia del viewcon- 
troller, il file .h, realizzato automaticamente quan- 
do si crea un nuovo progetto View-Based 
Application: 

#import <UIKit/UIKit.h> 

©interface ioProgrammoArt2ViewController : 

UlViewController {} 

@end 

Mentre quello che segue e il file .ra, sempre creato 
automaticamente quando si crea il nuovo progetto, 
sara: 

#import "ioProgrammoArt2ViewController.h" 
©implementation ioProgrammoArt2ViewController 

_r 

- (id)initWithNibName:(NSString *)nibNameOrNil 

bundle:(NSBundle *)nibBundleOrNil {...} 

- (void)loadView {} 

- (void)viewDidLoad {... } 

*/ /* 

-(BOOL)shouldAutorotateToInterfaceOrientation: 

(UllnterfaceOrientation)interfaceOrientation { 
return (interfaceOrientation = = 

UllnterfaceOrientationPortrait); } 
_V 

- (void)didReceiveMemoryWarning { 

[super didReceiveMemoryWarning]; } 

- (void)dealloc { 

[super dealloc]; } 
@end 

Quasi tutti i metodi sono commentati e, a seconda 
delle necessita, potrete decommentarli, o anche 
rimuoverli (non rimuovete gli ultimi due) vedremo 
nel prossimo articolo i loro possibili utilizzi. 
E all'interno di quest' ultimo file che scriveremo il 
codice che gestira qualunque tipo di operazione; 
ogni volta che inseriremo la signature di un deter- 
minato metodo all'mterno del file .h e logicamente 
necessario creare la sua implementazione, quindi il 
suo codice effettivamente funzionante, all'mterno 
del file .ra. In questo caso e stata creata (automati- 
camente) una classe associata ad un viewcontroller, 
che utilizzeremo per gestire l'interazione con 



l'utente, ma e possibile anche crearne un'altra deri- 
vante da UlView e associarla alia view contenuta 
nel viewcontroller, e demandare a questa la gestio- 
ne dell'interazione con l'utente (ricordiamo che 
qualunque componente visuale pub avere associa- 
ta una classe identificata da un file .h e .ra); 
l'affermazione precedente e valida poiche entram- 
be le classi derivano da una comune, chiamata UI 
Responder, che consente di monitorare la pressione 
da parte dell'utente fornendo ad entrambe alcuni 
metodi: touchesBegan, touchesCancelled, touches 
Ended, touchesMoved. II viewcontroller intercetta 
ogni input (il tocco con una o piu dita), poiche in 
questo progetto la nostra UlView e utilizzata sem- 
plicemente come contenitore di altri componenti 
visuali (infatti non e stata creata alcuna classe che 
ne rappresenti il suo Controller del pattern MVC). 
Se vogliamo quindi consentire l'interazione umana 
con il ViewController, che contiene la nostra View, 
dovremo effettuare alcuni passi utilizzando IB. In 
primis creeremo un file .xib (in questo caso e stato 
creato automaticamente), poi due file .he .ra, che 
estendono la classe che deve essere associata al 
componente grafico (anche in questo caso e stato 
creato automaticamente), nel nostro caso un 
UlViewController. Sara quindi necessario intercet- 
tare la pressione dell'utente, oppure richiamare 
uno o piu metodi se e stato premuto un pulsante o 
altro componente interattivo (keyword IBAction 
oppure adoperando delegate). Se desideriamo acce- 
dere facilmente nei nostri metodi a uno, o piu de- 
menti (pulsanti, label, webview etc) presenti nel 
ViewController dovremo, utilizzando la keyword 
IBOutlet, associare una variabile nel file .h a tale 
elemento grafico. II passo successivo consistera nel 
collegare all'interno di Interface Builder questa 
nuova classe con il componente visuale (facendo 
uso dell'Identity Inspector), quindi collegare 
(opzionalmente) quali metodi vengono richiamati 
quando l'utente interagisce con un determinato 
pulsante /componente interattivo. Sembra compli- 
cato ma dopo qualche incertezza diventera un 
automatismo che eseguirete con estrema velocita. 
L' operazione di associazione di un compoenente 
visuale a una classe e molto semplice: basta selezio- 
nare il componete grafico prescelto nel Document 
Window e successivamente selezionare la classe, 
precedentemente creata, all'interno del campo 
Class, contenuto nell' Identity Inspector. Nel prossi- 
mo articolo inseriremo un pulsante, una label e 
una webview, collegandoli tra loro utilizzando 
IBAction e IBOutlet, mostreremo l'alternativa forni- 
ta dall'utilizzo di delegate, gestendo tutto all'interno 
del file .ra del ViewController. Forniremo inoltre 
una descrizione delle diverse tipologie di compo- 
nenti grafici presenti. 

Andrea Leganza 
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APPLE IPHONE 
PROGRAMMING 

CONTINUIAMO IL CORSO INERENTE LA PROGRAM MAZIONE DEL DISPOSITIVO SMARTPHONE 
APPLE IPHONE, ILLUSTRANDO GLI STRUMENTI NECESSARI PER COMPLETARE L'APPLICAZIONE 
MINI BROWSER AWIATA NEL NUMERO PRECEDENTE DELLA RIVISTA 
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Mac OS X 10.5 o 
superiore 
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Tempo di realizzazione 



000 



Nell'articolo del numero precedente 
abbiamo creato un progetto View-Based 
Application utilizzando XCode, fornendo, 
inoltre, una breve descrizione di Interface 
Builder; in questo nuovo appuntamento, posi- 
zioneremo i componenti grafici, un bottone, un 
campo di testo e una UlWebView, owero un 
componente visuale che si comporta come un 
browser web, al pari del software Safari installato 
nell'iPhone. Seguiremo le procedure necessarie 
per rendere accessibili tali elementi aH'interno 
della classe (file .h e .m) del ViewController, 
scrivendo infine il codice utile per farli interagire 
e rispondere agli eventi generati dal tocco dell'u- 
tente. L' applicative consentira, al termine di 
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Fig. 1: L' interface ia che realizzeremo in questo articolo 



questo articolo, di digitare un qualunque indiriz- 
zo web nel campo di testo, rendendolo cosi 
visualizzabile nella UlWebView. 



DISPONIAMO 

GLI ELEMENTI GRAFICI 

Awiamo Interface Builder facendo doppio clic 
sul file ioProgrammoArt2ViewController.xib, ci si 
presentera a video l'interfaccia di Fig.2 
Trasciniamo i tre componenti all'interno della 
IJIView e ridimensioniamoli utilizzando i punti 




Fig. 2: Come si presente il file xib senza componenti 
aggiuntivi 



presenti ai bordi: alcuni componenti non posso- 
no subire variazioni in alcune direzioni, come 
awiene per il campo di testo che puo variare di 
lunghezza e non di altezza. 
Per il bottone bastera fare doppio clic sull'area 
che gli compete per impostare la stringa che 
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Fig. 3: 1 punti utilizzal 
di un campo di testo 
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verra visualizzata come label, oppure aprire 
1' Attribute Inspector {CTRL +1) e impostare il 
campo Title; per impostare il colore verde della 
view principale basta selezionarla e cliccare sul 
tasto Background, che in questo caso ha assunto 
valori RGB 201,255,156. La classe di appartenen- 
za di componenti visuali appena inseriti, la 
potrete identificare analizzando la colonna Type 
del Document Inspector di IB: UITextField, 
UlWebView e UIButton; queste tre informazioni 
ci permetteranno di creare delle variabili ad-hoc 
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F/g. 4: La classe dei singoli componenti e visibile 
in corrispondenza della colonna type 



nel prossimo paragrafo per utilizzarle nel codice 
Objective- C. 

Da questa immagine si ponga anche attenzione 

al tipo di struttura che abbiamo creato. 

La UlView principale, quella associata al nostro 

UlViewController, risulta la radice di un albero i 

cui tre figli sono proprio i tre componenti che 

abbiamo trascinato al suo interno. 

Parliamo ora di IBOutlet e IB Action, keyword che 

ci agiscono come bridge tra Interface Builder e 

XCode. 



COS E IBOUTLET 

Ora che abbiamo disegnato quella che sara la 
nostra interfaccia grafica, dobbiamo realizzare il 
codice necessario per il funzionamento del 
nostro applicativo, quella responsabile del 
Controller, scrivendo istruzioni Objective-C 
all'interno della classe chiamata ioProgmmmo 
Art2ViewController.m; prima di fare cio e necessa- 
rio spiegare come creare un collegamento tra i 
componenti visuali e oggetti in linguaggio 
Objectice-C, oggetti con i quali potremo interagi- 
re effettuando chiamate via codice: e in questa 
fase che viene creato un collegamento esplicito 
tra View e Controller. II modo piu semplice con- 
siste nell'effettuare una procedura costituita da 
due semplici passi: creare tante variabili quanti 
sono i componenti grafici con i quali vogliamo 
comunicare, tre in questo caso, all' interno del file 
responsabile dell'interfaccia della classe, quello 



con estensione .h, anteponendo alia classe di 
appartenenza usata nella dichiarazione della 
variabile, il termine IBOutlet, acronimo di 
Interface Builder Outlet; IBOutlet e un qualificato- 
re di tipo utilizzato solo per questo scopo, e quin- 
di una semplice macro vuota corrispondente alia 
riga in linguaggio C ^define IBOutlet, tale istruzio- 
ne, quando letta da Interface Builder, lo informa 
che vogliamo realizzare una connessione tra 
variabile Objective-C e oggetto visuale: 

//file ioProgrammoArt2ViewController.h 
#import <UIKit/UIKit.h> 



©interface ioProgrammoArt2ViewController : 

UlViewController 



IBOutlet UlWebView *webView; 
IBOutlet UITextField *addressField; 
IBOutlet UIButton *goButton; 



_} 

@end 

Le tre variabili hanno come classe di apparte- 
nenza la stessa dei componenti visuali, che 
potrete identificare sotto la colonna Type del 
Document Inspector di IB, come e stato mostra- 
to nel paragrafo precedente. I tre IBOutlet sono 
caratterizzati da una tipizzazione forte (strongly 
typed) proprio a indicare che a queste variabili 
possono essere associati solo elementi grafici 
delle classi da noi indicate; una versione meno 
restrittiva {weakly typed) verra mostrata successi- 
vamente, quando forniremo una versione piu 
generica di IBAction (che nel prossimo articolo 
verra spiegato approfonditamente). Le variabili 
create hanno come modificatore di accesso di 
default @protected, inaccessibili all'esterno, ma 
utilizzabile dalle classi che derivano dalla nostra 
(che in questo contesto e ininfluente, in un arti- 
colo successivo, descriveremo, tutti i modificato- 
ri disponibili). Questa prima parte della proce- 
dura ha un effetto immediato nella finestra delle 
proprieta del componente visuale chiamato File 
Owner, al quale e associata la classe ioProgra 
mmoArt2ViewController, accedendo quindi all'Ide 
ntity Inspector {CTRL+4) ritroveremo le tre 
variabili, all'interno della sezione chiamata Class 
Outlets, esposte dalla nostra classe. 
La seconda, e ultima parte della procedura, con- 
siste nel premere il tasto destro del mouse dopo 
aver selezionato la riga corrispondente al File 
Owner, a cui e associata la classe ioProgrammo 
Art2ViewController: tale operazione presentera 
una finestra semitrasparente nera nella quale 
troveremo di nuovo le tre variabili appena 




IL COMPONENTE 
UIWEBVIEW 

Questo componente svolge 
la funzione di browser web, 
consentendo di visualizzare 
pagine internet nel nostro 
applicativo. Consente 
anche di consultare altri 
tipi di documenti, tra cui 
PDF, XML, immagini e altri: 
e possibile considerarlo 
una panacea in situazioni 
in cui si vuole svolgere il 
piu velocemente un 
progetto, per limitazioni 
dell'API o per espressa 
volonta 



RIFERIMENTI WEB 

Per la creazione 
dell'account e per 
scaricare I 'SDK, visitate il 
seguente percorso web: 
http://developer.apple.co 
m/iphone 
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IBOUTLET 

IBOutlet viene utilizzato per 
notificare Interface Builder 
che tale variabile dovra 
essere utilizzata all'interno 
deH'interfaccia grafica, 
svolge quindi la funzione di 
connessione tra Controller 
e View, instaurando un 
collegamento bidirezionale. 
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Fig. 5: Dopo aver inserito le tre vatiabili all'interno del 
file .h, queste saranno visualizzate nell' Inspector delta 
classe in Interface Builder 



aggiunte alia classe. Bastera trascinare il cer- 
chietto, posizionato a destra, sul componente 
visuale che vogliamo associare. 
Tale operazione deve essere ripetuta per le tre 
variabili, associando a ognuna il rispettivo com- 

ioProgrammoArt2ViewController.xib O 

View Mode Into Search Field 

Name TvDe 

File's Owner i o Prog ram m o Art2 Vi e wCon trol le r 

1$ First Responder UlRespemder 

▼ ILJ ViewPrincipale UlView 

_ Round Style Text F... UlTextField 

_ Rounded Rett Butt... Ul Button 

WebView UlWebView 




Fig. 6: La finestra semitrasparente 



ponente visuale. Abbiamo cosi completato la 
procedura necessaria per accedere, nel file 
ioProgrammoArt2ViewController.m, a tali oggetti 



visuali e poterne cosi modificarne stato e aspet- 
to; e Titer piu semplice da seguire quando si ini- 
zia a lavorare con i file .xib. E inoltre possibile 
invertire tale procedura lasciando che Interface 
Builder crei una classe partendo daH'interfaccia 
che avete creato, operazione che risulta di gran- 
de utilita quando si hanno molti oggetti visuali e 
non si desidera inserirli manualmente, oppure si 
e deciso di realizzare prima il file xib della classe 
associata: questa ulteriore procedura verra spie- 
gata, ma in un prossimo articolo. 



LA COMUMICAZIOniE 
TRA GLI OGGETTI 

In ambito object oriented la comunicazione tra 
due classi awiene principalmente attraverso 
l'invocazione di metodi: in Objective-C tale ope- 
razione prende il nome di invio di messaggi. 
II design pattern, utilizzato per gestire gli eventi 
generati da un componente grafico, prende il 
nome di target-action; quando un utente interagi- 
sce con un componente lo induce a inviare un 
messaggio, chiamato action, a un altro oggetto, 
chiamato target, responsabile della sua gestione. 
E possibile procedere in modi diversi, a seconda 
della classe da cui derivano tali componenti: 
bottoni (UIButton) e campi di input di testo 
(UlTextField) ad esempio, possono richiamare, 
dei metodi presenti in una istanza di una classe 
utilizzando il qualificatore di tipo IBAction, ese- 
guendo una procedura molto simile a quella uti- 
lizzata nel paragrafo precedente (IBOutlet). 
Per visualizzare l'elenco degli eventi che vengo- 
no lanciati da un componente visuale e suffi- 
ciente premere il pulsante destro sul relativo 
oggetto presente nel Document Inspector di 
Interface Builder; con altri componenti si adope- 
ra la tecnica del delegate; una terza soluzione, 
disponibile per i componenti che discendono da 
UlControl, come UIButton, UlTextField UIDate 
Picker e altri, consiste nell'utilizzare i selector, 
adoperando istruzioni Objective-C; per ora trat- 
teremo solamente di IBAction. 



L'l INTERFACE BUILDER 
ACTION - IBACTION 

Con IBAction, acronimo di Interface Builder 
Action, identifichiamo quei metodi che 
Interface Builder mostrera all'interno della pro- 
pria interfaccia grafica quando e selezionata la 
classe in cui le abbiamo create, all'interno della 
sezione Class Actions del pannello Identity 
Inspector di IB (CTRL+4). Tali metodi rivestiran- 
no il ruolo di gestori degli eventi lanciati dai 
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componenti visuali. IBAction viene utilizzato al 
posto del tipo di ritorno della funzione, e infat- 
ti una macro, sinonimo di void {#define IBAction 
void), e per tale motivo tali metodi non restitui- 
scono alcun valore. Non e necessario creare 
una corrispondenza uno a uno tra un metodo 
IBAction e un evento richiamato da un singolo 
oggetto visuale, e possibile associare tale codice 
a un numero qualsiasi di eventi lanciati da 
altrettanti componenti visivi. Nel nostro pro- 
getto abbiamo necessita di gestire la pressione 
del pulsante, che prowedera in risposta a tale 
evento, a prelevare il valore del campo di input 
di testo e lo utilizzera per aprire la pagina rela- 
tiva all'interno del web View, per tale motivo la 
chiamiamo gotoAddress: 

//file ioProgrammoArt2ViewController.h 

#import <UIKit/UIKit.h> 

©interface ioProgrammoArt2ViewController : 

UlViewController 

{ 

IBOutlet UlWebView *webView; 



IBOutlet UITextField *addressField; 



IBOutlet UIButton *goButton; 



-(IBAction) gotoAddress; 



@end 

Abbiamo cosi esposto, semplicemente inseren- 
dola nel file di interfaccia e identificandola con 
IBAction, tale funzione in Interface Builder. 
La funzione ci sara presentata nell'area chiamata 
Class Actions di Interface Builder, nella sezione 
omonima dell' Identity Inspector. 
11 passo successivo consiste nell'associazione 
della funzione alia pressione del pulsante che 
abbiamo creato, operazione identica a quella uti- 
lizzata con IBOutlet; bastera quindi premere il 
tasto destro sulla riga corrispondente a File 
Owner per notare la disponibilita all'interno della 
categoria Received Actions 




A questo punto la domanda potrebbe sorgere 
spontanea: perche viene inserito in questa 
categoria, e non sotto Class Actions, cosi come 
awiene nelY Identity Inspector? Questo perche la 
pressione del tasto effettua una chiamata al 
nostro metodo e, dal punto di vista della classe, 
tale chiamata significa ricevere un'azione (un 
messaggio) da parte di un oggetto esterno, nel 
nostro caso un componente visivo; non fatevi 
confondere, quindi, sono sinonimi. 
Trasciniamo il cerchietto sul pulsante, ci verra 
presentato un elenco di eventi gestiti dal botto- 
ne, selezioniamo Touch Up Inside, (evento gene- 
rato quando l'utente solleva il dito dallo scher- 
mo dopo aver premuto il nostro pulsante). 
A questo punto non ci resta che scrivere il codi- 
ce del metodo gotoAddress, ma prima sara neces- 
sario spiegare come si invoca un qualunque 
metodo appartenente a un oggetto Objective-C. 




Fig. 8: L'effetto del tmscinamento del cerchietto 
telativo all 'IBAction sul pulsante 



Fig. 7: La ptesenza dell 'IBAction e ora mostrata anche 
in questa finestra 



Objective-C si differenzia principalmente da altri 
linguagg come Java, C#, Actionscript 3 poiche uti- 
lizza un approccio differente per il passaggio di 
parametri. 

Per implementare un metodo e necessario inserire 
a priori la sua signature, costituita da tipologia, tipo 
del valore restituito, nome, due punti, elenco e tipo 
dei parametri, nel file di interfaccia, come abbiamo 
fatto per -{IBAction) gotoAddress, terminata dal 
punto e virgola, poi scrivere il metodo completo di 
codice nel file di implementazione, quello con 
estensione .m. 

Un metodo che non accetta parametri verra scritto 
all'interno del file di interfaccia (.h) nel seguente 
modo: 

//file .h 

- (void) nomeMetodo; 

e verra invocato tramite la sintassi: 




VIEW-BASED 
APPLICATION 

E il progetto piii "comodo" 
per iniziare a programmare 
per iPhone/iPod Touch, 
infatti, fornisce una finestra 
contenuta all'interno di un 
controller, del quale viene 
fornita gia una classe di 
implementazione che 
consente al suo interno di 
gestire la parte di 
Controller, del pattern 
Model View Controller, 
responsabile, quindi, della 
gestione degli eventi e 
dello stato del nostro 
applicative 
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//file .m 



[oggetto nomeMetodo]; 

E quindi sempre necessario racchiudere tra 
parentesi quadre sia 1' oggetto che il nome del 
metodo invocato. Nel caso restituisca un intero: 



(alias) che assumera all'interno del corpo del 
metodo. II calcolo del fattoriale di un numero 
avra questa signature: 

//file .h 

-(double) FattorialeDi: (int) pari; 



//file .h 



- (int) nomeMetodo; 

sara possibile utilizzare tale risultato associan- 
dolo a una variabile nel seguente modo: 



Che sara utilizzato in questo modo: 



//file .m 



int i = 5; 



double risultato = [oggetto FattorialeDi :i]; 



//file .m 



IBACTION 

IBAction viene utilizzato per 
identificare un metodo di 
una classe, in modo da 
notificare Interface Builder 
che tale blocco di codice 
potra essere invocato da 
un componente grafico; 
alio scaternarsi di uno o piu 
eventi consente, inoltre, di 
esporre tale metodo 
alllnterno di quelli forniti 
da un determinato oggetto 
visuale di IB. Cio avviene 
quando si preme il destro 
sulla relativa riga nel 
document inspector. 



int variabile = [oggetto nomeMetodo]; 

II simbolo - che precede ogni metodo, indica 
che questo e associato all'istanza, sostituendolo 
con un + lo si associa alia classe, verra quindi 
invocato nel seguente modo: 

//file .m 

int variabile = [nomeClasse nomeMetodo]; 

In questi articoli, a meno di precisa motivazione, 
avremo sempre la necessita di creare metodi per 
consentire la chiamata a una istanza di oggetto, 
utilizzeremo percio il -. 

Esiste un modo per associare un modificatore di 
accesso {public, protected, private), a un metodo? 
Non esplicitamente, per rendere un metodo pri- 
vato si possono usare le categorie, ma non e 
argomento di questo articolo: l'importante, per 
ora, e essere consapevoli che qualunque metodo 
e visibile all'esterno, da parte delle altre classi, a 
meno di utilizzare degli accorgimenti particolari, 
e che se non scriverete neH'implementazione 
della classe tutti i metodi dichiarati nell'interfac- 
cia, verrete awisati con il seguente warning: 

warning: incomplete implementation of 

class 'ioProgrammoArt2ViewController' 

warning: method definition for '- 

nomeMetodo:' not found 

Nel caso un metodo accetti un parametro, si uti- 
lizza la seguente sintassi: 

//file .h 

-(void) nomeMetodo: (tipoSingoloParametro) pari; 



Con piu parametri, due in questo caso, si utilizza: 

//file .h 

-(void) nomeMetodo: (tipoPri mo Para metro) pari 
nomeSecondoParametro: (tipoSecondoParametro) par 2; 

Se volessimo realizzare un metodo che effettua la 
somma tra due interi, si potrebbe utilizzare quin- 
di la seguente sintassi: 

//file .h 

-(void) Somma: (int) pari con: (int) par 2; 

Da invocare nel seguente modo: 

//file .m 

int i = 100, j = 50; 

int result = [oggetto Somma :i con:j]; 

E possibile effettuare chiamate in cascata come 
nel seguente esempio: 

int result = [oggetto Somma: [oggetto Somma :i con; 

j] con: J]; 

II cui risultato e la somma il numero delle 

chiamate e teoricamente illimitato, ma tale 
approccio ha il difetto di incrementare i rischi di 
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Fig. 9 II sistema d'evidenziazione della parentesi quadra 



Qui si nota la netta differenza con i linguaggi 
Object Oriented di "nuova" generazione; analiz- 
zandolo notiamo che i parametri seguono il sim- 
bolo dei due punti, poi si evince che non e pre- 
sente un nome per il primo parametro, questo ha 
solo associati il tipo di appartenenza e il nome 



errori per la necessita di porre attenzione alia posi- 
zione delle parentesi quadre, sia aperte che chiuse: 
XCode ci viene in aiuto, infatti, posizionando il 
cursore su una parentesi, verra automaticamente 
evidenziata quella di chiusura corrispondente (o 
di apertura nel caso selezionassimo l'altra). 
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IL CODICE 

Dl GOTOADDRESS 

Ora che abbiamo spiegato come invocare un 
metodo generico, dovremo semplicemente pre- 
levare il testo del campo addressField e passarlo 
come indirizzo a webView. Creiamo il metodo 
all'interno del file ioProgrammoArt2ViewControl- 
lerm, nel codice identificato dal blocco (^imple- 
mentation . . . @end: 

//file ioProgrammoArt2ViewController.m 
#import "ioProgrammoArt2ViewController.h" 
©implementation ioProgrammoArt2ViewController 
-(IBAction) gotoAddress{ 
//Corpo del metodo 



} 



@end 

Per prelevare il testo dal campo di input e aprire 
la pagina web (se esistente), bastera utilizzare il 
seguente codice: 

-(IBAction) gotoAddress{ 

//Preleviamo I'indirizzo 

NSString *address = [addressField text]; 

//Creiamo un indirizzo utilizzando tale stringa 

NSURL *url = [NSURL URLWithString:address]; 

//Creiamo una richiesta con tale indirizzo 
NSURLRequest *request = [NSURLRequest 

requestWithURL:url]; 

//Carichiamo la pagina utilizzando tale richiesta 
[webView loadRequest: request]; 



Quando "cliccheremo" sul campo di testo si pre- 
sentera la tipica tastiera e, successivamente, alia 
pressione del bottone verra caricata la pagina 
richiesta. E possibile raggruppare le chiamate 
effettuate in una sola riga: 

[webView loadRequest: [NSURLRequest 
requestWithURL: [NSURL URLWithString: [addressField 

text]]]]; 

Come detto precedentemente, questa versione del 
codice risulta essere poco leggibile, a meno di non 
aver maturato una certa esperienza. Abbiamo 
completato la prima fase di questo semplice pro- 
getto. Ora, iniziamo a spiegare in dettaglio alcune 
caratteristiche deH'Objective-C e dell'interfaccia- 
mento con Builder, perche ci consentiranno di 
aggiungere ulteriori funzionalita nel prosieguo. 



IBACTION E ID 

II precedente utilizzo di IBAction ha la limitazio- 
ne di non fornire alcuna informazione sull'og- 



getto che lo ha invocato, nel nostro caso il botto- 
ne chiamato goButton, per tale motivo e disponi- 
bile una versione piu completa, che nel nostro 
esempio sara la seguente: 

/file ioProgrammoArt2ViewController.h 

- (IBAction)gotoAddress:(id)sender; 

Abbiamo semplicemente aggiunto un parame- 
tro, di tipo id di nome sender che potremo utiliz- 
zare all'interno del blocco di codice del metodo 
per avere informazioni sull'oggetto che ha invo- 
cato tale comando. Questa funzionalita permette 
di condividere un IBAction tra un numero illimi- 
tato di oggetti, non solo di numero, ma anche di 
tipo, spettera a noi analizzare la variabile sender 
per capirne la tipologia. Un tipico esempio di uti- 
lizzo e quello in cui abbiamo numerosi bottoni e 
desideriamo avere una sola zona di codice 
responsabile della loro gestione, utilizzando 
sender potremo identificare chi e il chiamante e, 
se necessario, modificarlo opportunamente. 
Esiste un'ulteriore versione, la piu dettagliata 
disponibile, nella quale abbiamo modo anche di 
identificare l'evento che l'ha invocata: 

/file ioProgrammoArt2ViewController.h 

- (IBAction)gotoAddress:(id)sender 

Event: (UIEvent*)event; ; 

Tale variabile risulta utile se decidiamo di associ- 
re il metodo contemporaneamente a piu eventi, 
utilizzando, ad esempio, Touch Up Inside e Touch 
Down, eventi "scatenati", in occasioni diverse, dal 
controllo afferente UITextlnput. 
II "difetto" di tali metodi e dovuto al tipo del para- 
metro utilizzato, id, il che rappresenta il tipo piu 
generale possibile, che, se da un punto di vista 
consente grande liberta su quale componente 
utilizzare per invocare tale IBAction, dall'altro 
introduce alcune problematiche, principalmen- 
te riguardanti l'accesso ai campi e a i metodi del- 
l'oggetto chiamante. Nel prossimo articolo a tale 
concetto dedicheremo particolare attenzione; 
Futilizzo consapevole di id consente di accedere 
alia estrema versatility fornita dal linguaggio 
Objective -C. 



ALLA PROSSIMA... 

Creata una versione funzionante dell' appli- 
cative nel prossimo articolo del corso, lo 
modificheremo per fornire ulteriori funzionalita. 
Faremo cosi conoscenza con altri argomenti 
correlati. Buona programmazione. 
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CREARE SOFTWARE 
PER L'APPLE IPHONE 

IN QUESTATERZA LEZIONE MODIFICHIAMO IL MINIBROWSER INTRODOTTO NEL PRECEDENTE 
ARTICOLO DELLA SERIE, INTRODUCENDO ALTRI CONCETTI FONDAMENTALI COME LA 
GESTIONE DEGLI ASPETTI GRAFICI E L'UTILIZZO DEL COMPONENTE UIWEBVIEW 
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Nel precedente articolo abbiamo comple- 
tato un'interfaccia minimale e abbiamo 
realizzato la logica necessaria per il suo 
corretto funzionamento, ora ci dedicheremo 
all'introduzione di ulteriori caratteristiche del 
linguaggio Objective -C; aggiungeremo un'ani- 
mazione per monitorare il caricamento della 
pagina web richiesta. 



IL TIPO ID 

Nella seconda versione del metodo gotoAddress, 
introdotto nell'articolo precedente, che qui 
riproponiamo per semplicita, 

//file ioProgrammoArt2ViewController.h 

(IBAction)gotoAddress:(id)sender; 

abbiamo utilizzato un parametro di tipo id, che 
ci ha consentito di rendere il piti generale possi- 
ble tale chiamata, in grado di essere invocata da 
qualunque componente visuale (ma non solo, e 
capirete il perche a breve): e necessario discuter- 
ne approfonditamente, poiche incontrerete id sia 
nell'API che nella documentazione; id, attenzio- 
ne e privo dell'asterisco, simbolo utilizzato quan- 
do ci si riferisce alle istanze delle classi, esiste 
perche Objective-C e un linguaggio a tipizzazione 
dinamica, cio significa che solo a runtime, in ese- 
cuzione, il vostro software avra realmente modo 
di capire se una variabile appartiene ad un deter- 
minate tipo di dato, avra quindi una struttura 
derivante alia sua catena di ereditarieta, parten- 
do dalla root (in genere e NSObjecf), e scendendo 
progressivamente, risultando percio corredato 
da precisi metodi e variabili; questo comporta- 
mento e completamente diverso da quello che 
presente in JAVA e C#, linguaggi a tipizzazione sta- 
tica, dove tale controllo awiene in fase di compi- 
lazione, e durante il quale si riceve un errore nel 
caso si assegni a un'istanza di una classe un tipo 
diverso da quello della sua catena di ereditarieta 



(attribuendo ad esempio, il contenuto di una 
variabile String a una istanza di una classe creata 
estendendo un componente Swing) oppure si 
richiama un metodo inesistente (con parametri 
di tipo e/o numero diversi); in Objective-C se 
vengono rilevati dei conflitti o delle omissioni si 
riceve solamente un awiso, un warning in fase di 
compilazione, bisogna prendere consapevolezza 
che in tale contesto tutto e incerto riguardo una 
variabile tranne quando si e in esecuzione; solo 
gli errori sintattici, come parentesi e punti e vir- 
gola mancanti, interrompono il processo di com- 
pilazione. Associando, ad esempio, una variabile 
di tipo UITextField a una di tipo UlWebView, ope- 
razione concettualmente errata, ma perfetta- 
mente lecita in questo linguaggio: 

UlWebView *oggettoBrowser; 

UITextField *oggettoCampoDiTesto= oggettoBrowser; 

riceveremo il seguente awiso: 

warning: 'initialization from distinct Objective-C type' 

Per i metodi il discorso e molto simile: il compi- 
latore, se richiameremo un metodo inesistente, o 
sconosciuto al momento di compilazione come 
nel seguente caso: 

//Definizione della variabile 
UILabel *oggettoLabel; 

//inizializzazione della variabile 



//Chiamata del metodo 
[oggettoLabel metodolnesistente] ; 

segnalera la mancanza di informazioni a riguar- 
do con il seguente awiso 



warning: 'UITextField' may not respond to 
'metodolnesistente ' 
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Notate il may utilizzato per denotare tale incer- 
tezza al momento della compilazione. Anche 
sbagliare la chiamata, invertendo "semplicemen- 
te" il tipo dei parametri, vi verra segnalato come 
un warning, e non un errore, il compilatore pre- 
suppone che sappiate cosa stiate facendo e si 
aspetta, a runtime, di trovare questo metodo con 
tale diversa signature. II vostro software verra 
comunque compilato e awiato senza alcuna 
limitazione, il problema si presentera a runtime e 
il risultato sara uno, o piu crash, con il conse- 
guente awio del debugger (spesso molto vago 
sulla causa scatenante del crash). Attenzione 
quindi ai warning del compilatore, perche sono il 
primo segnale di un errore semantico e quindi di 
un possibile crash! Da quanto detto, si ha 
un'estrema liberta (anche di sbagliare) nell' edi- 
tor, ma si e di conseguenza poco "assistiti" dal 
compilatore per prevenire molti tra gli errori piu 
comuni, che si erano risolti con i linguaggi di 
nuova generazione, per merito dei loro controlli 
preventivi. 

Per merito di questa dinamicita intrinseca al lin- 
guaggio, e possibile utilizzare un "placemark", un 
indicatore, per segnalare che un determinato 
oggetto al momento della compilazione non 
appartiene a una classe predefinita, perche non e 
conosciuta a priori o non la si vuole specificare: 
in entrambi i casi si utilizza id come tipo della 
variabile. Nella documentazione relativa a 
IBAction viene utilizzato id per la signature, per 
indicarne la completa indipendenza dalla classe 
chiamante; id ha inoltre avuto il pregio di sem- 
plificare il processo di creazione dell 'API, evitan- 
do di realizzare un metodo per ogni oggetto chia- 
mante, poiche potrebbe appartenere a una qual- 
siasi delle decine di classi disponibili, UIButton e 
UITextField e via discorrendo; in casa Apple ci si 
e mantenuti il piu generale possibile, lasciando 
quindi al programmatore piena liberta in che 
modo gestire tale chiamante. Id ha comunque 
delle limitazioni, a livello di usabilita: se si defini- 
sce una variabile di questo tipo non e possibile 
avere un elenco preciso, utilizzando il sistema di 
Code Completition, delle funzioni e delle varia- 
bili appartenenti a tale oggetto, poiche XCode 
non ha modo di sapere su che classe specifica si 
sta lavorando, riceveremo percio un elenco esau- 
stivo di tutti i metodi disponibili per tutte le clas- 
si presenti nell'API: migliaia di metodi, variabili e 
costanti, una lista di scarsa utilita! 
Id pub generare confusione nel codice se 
l'utilizzo dell'oggetto associato non viene oppor- 
tunamente descritto, oltre a incrementare il 
numero di possibili bug, poiche si potrebbero 
chiamare metodi, e provare ad accedere a varia- 
bili, non presenti a runtime. Come e possibile 
limitare 1' elenco dei metodi, e dei campi, sugge- 



riti da XCode quando siamo certi del tipo di 
variabile che id assumera a runtime? Nel nostro 
caso e del tipo UIButton, un bottone, passato 
come parametro sender nel metodo IBAction. La 
soluzione e molto semplice, basta creare una 
variabile del tipo desiderato e associarle il para- 
metro sender; se pensiamo di utilizzarla un certo 
numero di volte, potremo utilizzare nel bio ceo di 
codice il seguente codice: 

-(IBAction)gotoAddress:(id)sender { 



UIButton *mioBottone = sender; 



[mioBottone metodollno]; 
[mioBottone metodoDue]; 



} 

Oppure utilizzare il casting: 

-(IBAction)gotoAddress:(id)sender { 

[(UIButton *)sender metodoUno]; 
[(UIButton *)sender metodoDue]; 



} 

Quest'ultima tecnica dovra essere utilizzata per 
ogni chiamata effettuata e/o per accedere ad un 
campo della classe, alio scopo di "forzare" 
1' editor a mostrare il corretto, e limitato, elenco 
di metodi e variabili; questa tecnica risulta pero 
alquanto scomoda, degradando la leggibilita del 
codice, oltre ad incrementare il numero di carat - 
teri da digitare. Se volessimo evitare di utilizzare 
id in questo contesto, potremmo semplicemente 
sostituirlo con il tipo corrispondente al compo- 
nente grafico chiamante, UIButton nel nostro 
caso: 

-(IBAction)gotoAddress: (UIButton *)sender { 
[sender metodoUno]; 
[sender metodoDue]; 



} 

In questo modo l'operazione di casting verra 
effettuata automaticamente. Applicando una 
qualunque di queste soluzioni, riceveremo sug- 
gerimenti coerenti con la classe che abbiamo 
specificato. L'unica limitazione dell'ultima solu- 
zione e che impedisce la condivisione di tale 
IBAction con quei componenti che non appar- 
tengono alia classe UIButton, rendendo quindi 
impossible qualunque associazione diversa da 
quella tramite Interface Builder. Id puo essere 
utilizzato per qualunque variabile presente nella 
nostra classe, anche per gli IBOutlet; nell'articolo 




ID 

/c/svolge lafunzione di 
identificatore generico di 
classe; una variabile di tale 
tipo puo appartenere a 
qualunque classe e la sua 
reale identita potra essere 
evidenziata solo a tempo di 
esecuzione; ha il difetto di 
non fornire informazioni se 
uno o piu metodi, o campi, 
a cui si accede esistono 
effettivamente a runtime, 
cio incrementa il rischio di 
bug e crash del sistema, se 
non viene utilizzato con 
accortezza. 



RIFERIMENTI WEB 

Per la creazione 
dell'account e per 
scaricare I'SDK, visitate il 
seguente percorso web: 
http://developer.apple.co 
m/iphone 
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IDENTIFICARE 
LA REALE CLASSE 
Dl ID 

La necessita di utilizzo di id 
e relativamente ridotta, 
conviene adoperarlo in 
situazioni di 
indeterminatezza a 
runtime; per identificare la 
reale classe di una sua 
istanza, basta invocare su 
di essa (piu correttamente 
"inviare un messaggio") 
uno dei seguenti metodi: 



(BOOL)isKindOfClass: 



precedente avevamo infatti detto che i tre 
IBOutlet utilizzati erano a tipizzazione forte, 
(strongly typed), cioe limitavano i tipi di compo- 
nenti visuali che potevamo associare, evitando 
possibili errori di collegamento in Interface 
Builder. Con l'introduzione di id, possiamo ora 
rendere piu dinamiche tali associazioni, bastera 
modificare il codice nel seguente modo: 

IBOutlet id webView; 
IBOutlet id addressField; 
IBOutlet id goButton; 

Questa versione, con id, chiamata anche a tipiz- 
zazione debole (weakly typed) e quindi la piu 
generica tra quelle disponibili e consente di 
associare qualunque elemento visuale alle tre 
variabili: potremo quindi associare un campo di 
testo (visuale) al nostro webWiew (variabile) 
senza che il compilatore o Interface Builder 
segnali alcun problema; anche in questa situa- 
zione l'utilizzo indiscriminato di id, piu che altro 
privo di sufficiente conoscenza, rischia di incre- 
mentare il numero di possibili chiamate a meto- 
di o accesso a campi inesistenti, con la genera- 
zione di numerosi crash. Per soddisfare la curio- 
sita di alcuni sulla reale identita di id bisogna 
consultare la documentazione e si verra a cono- 
scenza che e un semplice puntatore a una strut- 
tura che contiene la "classe", che verra utilizzata 
a runtime: 

typedef struct objc_object { 

Class isa; 
} *id 



(Class)aClass Tale Class e un puntatore a una struttura: 



-(BOOL)isMemberOf 
Class:(Class)aClass; 

questi due consentono di 
ottenere un riscontro 
immediate, fornendoci le 
informazioni necessarie per 
effettuare un casting alio 
scopo di scegliere 
operazioni coerenti con la 
reale identita dell' istanza. 



typedef struct objc_class *Class; 
definita nel seguente modo: 
struct objc_class { 



struct objc_class *isa; 



struct objc_class *super_class; 



const char *name; 



long version; 



long info; 



long instance_size; 



struct objc_ivar_list *ivars; 



struct objc_method_list ** method Lists; 



struct objc_cache *cache; 



struct objc_protocol_list *protocols; 



}; 



nella quale troviamo tutte le informazioni che 
rappresenteranno lo stato delT istanza che id 
conterra, tra cui metodi, variabili, protocolli, e 



altri dettagli; passando attraverso id siamo quin- 
di giunti alia struttura che viene utilizzata per 
realizzare in Objective -C, utilizzando il linguag- 
gio C, ogni classe che utilizziamo. 
Pub venire il dubbio, in alcuni contesti, se 
NSObject, poiche e la root delle classi che abbia- 
mo fino ad ora utilizzato, e intercambiabile con 
id; la risposta a tale domanda e: dipende; id puo 
ospitare qualunque istanza appartenente a una 
classe anche non discendente da NSObject 
(come NSProxy e Protocol); una qualunque chia- 
mata a un metodo, o accesso a un campo, di id 
non viene verificata, e segnalata in caso di inesi- 
stenza o incongruenza, in fase di compilazione, 
mentre se attribuiamo a una variabile il tipo 
NSObject, riceveremo un warning se invochiamo 
uno, o piu, metodi non esposti da tale classe di 
root; come e stato detto, il sistema di completa- 
mento del testo per id risulta praticamente inuti- 
lizzabile, presentando tutti i metodi disponibili 
nell'API, nel caso di NSObject, invece, ricevere- 
mo quei metodi presenti in tale classe, senza 
pero ottenere quelli forniti dalla catena di eredi- 
tarieta: in entrambi i casi, per ottenere l'elenco 
piu coerente di metodi e necessario effettuare il 
casting alia classe piu specifica desiderata, come 
e stato mostrato negli esempi di gotoAddress. 



Con delegation, o message forwarding (conosciuto 
anche con i nomi di consultation e aggregation), si 
intende quella procedura che ha come risultato 
rindirizzamento degli eventi che una classe genera 
verso un'altra, presente al proprio interno come 
una variabile, e che viene configurata per gestirli 
opportunamente; tale nome e usato per descrivere 
un design pattern, descritto in ingegneria del 
software, che ha proprio questo comportamento; 
con delegate si intende una proprieta della classe, 
identiflcata con una variabile di tipo id, che viene 
utilizzata per realizzare la delegation. Non tutte le 
classi forniscono tale variabile, nel nostro progetto 
e disponibile per 1' UITextField e UlWebView, owia- 
mente e la documentazione la fonte migliore per 
determinare se la supportano. Quando utilizzare il 
delegate? Come abbiamo detto precedentemente, 
in questo contesto le classi svolgono la funzione di 
Controller dei componenti visuali, a volte pero non 
e necessario, o non si desidera, creare una classe 
che realizzi il Controller per ognuno di questi ele- 
menti, ma si vuole, comunque, gestire una certa 
famiglia di eventi inviati da tali istanze; un tipico 
esempio e quello della UITableView, una tabella 
visuale che mostra una serie di dati in sequenza; in 
genere si fa delegare tutta la sua gestione, insieme 
alia visualizzazione delle proprie informazioni e 
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alTinterazione dell'utente, al UWiewController che 
la contiene (utilizzando il protocollo UITable 
ViewDataSource di cui parleremo nel prossimo 
paragrafo). E possibile impostare il delegate in 
due modi: il primo consiste nell'utilizzare 
Interface Builder, premere il destro del mouse 
sulla riga corrispondente al componente visuale 
del Document Inspector, noterete una riga con 
tale nome, e potrete associare tale proprieta a un 
oggetto semplicemente trascinando il relativo 
cerchietto, come e stato fatto per gli IBOutlet 
L'altro consiste nell'utilizzare un comando in lin- 
guaggio Objective-C: 

mialstanza. delegate = oggettoDelegato; 

II risultato e identico, Tunica differenza e che nel 
secondo caso si ha modo di controllare quando 
inizializzare tale associazione, mentre nel primo 
awiene in un non precisato momento durante la 
trasformazione del file xib, che, come detto pre- 
cedentemente, e un file XML, nel codice Objec 
tive-C necessario per realizzare l'interfaccia gra- 
fica da inserire nell'eseguibile. Abbiamo cosi 
impostato che 1' oggetto mialstanza delega la sua 
gestione a oggettoDelegato. Impostare il delegate 
di un'istanza di una classe non e pero sufficiente 
affinche tale delegato possa intercettare ed ela- 
borare gli eventi: e necessario che tale classe 
implementi i metodi che verranno richiesti, 
diventi cioe conforme ad un protocollo. II nome 
di tale protocollo, corredato del relativo elenco di 
metodi, lo si ritrova nella documentazione asso- 
ciata al parametro delegate della classe sulla 
quale volete applicare la delegation. Per sempli- 
ficare questa procedura e disponibile, nel caso 
della suddetta UITableView, una componente 
visuale chiamata UITableViewController che 
consiste proprio in un UWiewController e una 
UITableView al suo interno, gia configurato in 
questo modo. 



I PROTOCOLLI 

II concetto di protocollo suonera familiare a 
molti utilizzatori di linguaggi object-oriented di 
nuova generazione, perche in Java, come in C#, 
vengono chiamati Interfacce, mentre Classi 
Astratte in C++. Diventare conforme (a volte si 
utilizza il termine adattarsi) a un protocollo, nella 
pratica significa garantire che una determinata 
classe utilizza, ha quindi implementato, tutti i 
metodi dichiarati nel protocollo rispettando i 
nomi, il tipo e il numero dei parametri utilizzati; 
il comportamento interno dei metodi non inte- 
ressa al protocollo, e demandato al programma- 
tore. Un esempio e quello dell' UITable ViewData 



Source, citato nel paragrafo precedente quando 
parlavamo della UITableView associata a un 
UWiewController, questo espone i seguenti meto- 
di (e solo un estratto): 

©required 

- (NSInteger)tableView:(UITableView *)table 

numberOfRowsInSection : (NSInteger)section ; 

- (UITableViewCell *)tableView:(UITableView *) 

tableView cellForRowAtIndexPath:(NSIndexPath *) 

indexPath; 

©optional 

- (NSInteger)numberOfSectionsInTableView: 
(UITableView *)tableView; 

- (NSString *)tableView:(UITableView *)tableView 

titleForHeaderlnSection : (NSInteger)section ; 

- (NSString *)tableView:(UITableView *)tableView 

titleForFooterInSection:(NSInteger)section; 



come si pub notare immediatamente, da una 
prima analisi di tale codice, non viene inserito 
alcun blocco di comandi Objective-C alFinterno 
dei metodi, ma troviamo semplicemente il nome e 
i parametri. Ogni protocollo e da considerare al 
pari di un "patto" con il quale si garantisce che si 
rispetta un certo standard, almeno riguardo i nomi 
ed i parametri. I protocolli vengono suddivisi in 
due categorie: formali ed informali: con i primi si 
indicato quelli che, utilizzando solo la keyword 
@required, obbligano l'implementazione di tutti i 
propri metodi, mentre con i secondi si fornisce 
libera scelta su quale sottoinsieme di metodi realiz- 
zare, indicazione che awiene utilizzando la 
keyword @optional\ dichiarando la conformita di 
una nostra classe a uno o piu protocolli formali 
richiedera un controllo da parte del compilatore in 
fase di compilazione, al contrario di quelli informa- 
li, che vengono completamente ignorati. Le inter- 
facce utilizzate in Java e/o C#, sono quindi compa- 
rabili ai protocolli formali. Ma perche in Objective- 
C e possibile avere tale liberta di scelta? Merito del 
fatto che, come e stato detto precedentemente, e 
un linguaggio a tipizzazione dinamica: anche il 
controllo se una classe rispetta un determinato 
protocollo, awiene a runtime, utilizzando un pro- 
cedimento chiamato reflection, tramite il quale la 
classe viene interrogata (o piu correttamente si 
interroga) se ha certe caratteristiche. Da quando 
detto potremmo implementare tutti i metodi 
necessari per il protocollo UITableViewData Source 
senza dichiararlo esplicitamente, tanto, se vengono 
rilevati in fase di esecuzione verranno comunque 
invocati. Analizzando i metodi presenti nella classe 
di root, NSObject, troviamo il seguente metodo: 

- (BOOL)conformsToProtocol: (Protocol *)aProtocol 



DELEGATE 

Con delegate si identifica 
quella istanza di una classe 
responsabile della gestione 
degli eventi lanciati da un 
altro oggetto; risulta utile 
quando si realizzano 
interfacce con numerosi 
componenti visuali e si 
preferisce centralizzare il 
codice alllnterno di un 
numero piu ristretto di 
classi. 



DEASOCCIARE 
IL DELEGATE 

Quando si imposta 
manualmente il delegate 
con oggetti che lanciano 
eventi asincroni, come pud 
accadere nel nostro 
UlWebView, si rischia di 
incorrere in chash casuali 
se non si deallocano 
correttamente le risorse 
associate se si rimuove il 
controllore; tale evento 
accade frequentemente 
quando si utilizza 
un controller 
UlNavigationController, 
conviene quindi rimuovere 
questo legame nel metodo 
dealloco appena possibile; 
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IBACTION 

IBActionwene utilizzato per 
identificare un metodo di 
una classe, in modo da 
notificare Interface Builder 
che tale blocco di codice 
potra essere invocato da 
un componente grafico; 
alio scaternarsi di uno o piu 
eventi consente, inoltre, di 
esporre tale metodo 
aH'interno di quelli forniti 
da un determinato oggetto 
visuale di IB. Cio avviene 
quando si preme il destro 
sulla relativa riga nel 
document inspector. 




DEASOCCIARE 
IBOUTLET 

Ogni volta che si utilizza un 
IBOutlet, dichiarandolo 
all'interno del file .h e 
associandolo ad un 
componente visivo tramite 
Interface Builder, 
e necessario rilasciare la 
memoria che gli viene 
riservata a runtime; tale 
operazione viene effettuata 
invocando il metodo 
release sul relativo IBOutlet 
all'interno del metodo 
dealloc. 



il cui scopo e proprio quello di fornire una rispo- 
sta certa se si rispetta un determinato protocollo; 
tale metodo viene invocato automaticamente 
numerose volte durante l'esecuzione del vostro 
applicativo in maniera completamente traspa- 
rente. Dichiarare esplicitamente che una classe e 
conforme a uno, o piu, protocolli permette sia di 
sapere quali metodi sono obbligatori (nel caso 
dei formali), perche anche una sola omissione 
viene segnalata dal compilatore, ma soprattutto 
e una pratica di buona programmazione (valida 
sia per i formali che per gli informali), rendendo 
palesi le proprie intenzioni anche ad altri svilup- 
patori che potrebbero analizzare in futuro il 
vostro codice. Per dichiarare se una classe e 
conforme a un protocollo, utilizziamo ad esem- 
pio quello mostrato precedentemente, UITable 
ViewDataSource, e sufficiente inserire il suo iden- 
tificativo, racchiuso tra i due simboli minore e 
maggiore, all'interno del file di interfaccia della 
classe, successivamente alia classe da cui deriva 
la nostra: 

©interface ioProgrammoArt2ViewController : 

UlViewController <UITableViewDataSource> 

Per aggiungere ulteriori protocolli basta sempli- 
cemente separarli con una virgola. 
UITable ViewDataSource e un protocollo che 
dichiara sia metodi obbligatori (due) che opzio- 
nal (numerosi), saremo quindi obbligati a imple- 
mentare solo i primi due, numberOfRowsInSect 
ion e cellForRowAtlndexPath. La frase con cui e 
stato terminato il paragrafo precedente e quindi 
parzialmente vera, e necessario dichiarare espli- 
citamente di essere conformi a uno o piu proto- 
colli formali, ma e buona pratica farlo anche per 
quelli informali. E importante disaccoppiare il 
delegate quando rimuoviamo le risorse associate 
a un UlViewController che contiene la nostra 
classe, tale operazione si effettua semplicemente 
impostandolo al valore nil: 

mialstanza. delegate = nil; 

Si tratta di un' operazione necessaria, poiche, se 
vengono inviati messaggi al delegate quando que- 
sto non e piu disponibile, in genere dopo essere 
stato deallocato, si verifichera un crash a runtime; 
un errore comune e quello che si presenta quando 
si analizzano i dati dell'accelerometro e non si 
effettua tale procedura di rilascio. Concludiamo 
questo argomento suggerendo di porre una certa 
attenzione nella fase di scrittura della signature dei 
metodi, poiche una qualunque differenza con la 
versione attesa non permettera a questi di essere 
invocati quando necessario: la procedura piu sicu- 
ra consiste nell'effettuare una operazione di copia, 



prelevando le signature dalla documentazione del 
protocollo, e incolla, all'interno di XCode. 



IL CARICAMENTO 
DELLA PAGIIMA 

Nel nostro progetto decidiamo di monitorare il 
caricamento della pagina web mostrando, quan- 
do questo processo non e ancora terminato, 
un'animazione; per semplicita utilizziamo un 
UIActivitylndicatorView, un componente visuale 
che mostra un'animazione infinita (ma comun- 
que interrrompibile), il tipico effetto di una spi- 
rale rotante, familiare agli utenti Mac. 
Abilitiamo, tramite la finestra Attributes Inspector 
{CTRL+1) di IB, la voce Hide When Stopped, in tal 
modo nasconderemo automaticamente tale 
componente quando interromperemo la sua 
l'animazione. Per accedere nella nostra classe 
io Pro gram mo A rt2 Vie wCo n tr oiler, m a tale com- 
ponente visuale dobbiamo aggiungere, effet- 
tuando anche il collegamento in IB, un nuovo 
IBOutlet all'interno di ioProgra m m oA rt2 Vie w- 
Controller.h: 

//file ioProgrammoArt2ViewController.h 

#import <UIKit/UIKit.h> 

©interface ioProgrammoArt2ViewController : 

UlViewController { 

IBOutlet UlWebView *webView; 

IBOutlet UITextField *addressField; 

IBOutlet UIButton *goButton; 

IBOutlet UIActivitylndicatorView *loadMonitor; } 

@end 

Ricordate di associarlo in Interface Builder, altri- 
menti non si avra modo di accedervi nei metodi 
che realizzeremo. Per mostrare l'utilita della 
delegation, invece di realizzare una classe da 
associare alia UlWebView, andremo a impostare 
come delegate di questo componente visuale il 
nostro UlViewController; come precisato prece- 
dentemente, e conveniente impostare il proto- 
collo, anche se non espressamente richiesto; 
consultando la documentazione veniamo a 
conoscenza che il suo delegate e del tipo 
id<UIWebViewDelegate>, dovremo quindi essere 
conformi al protocollo UIWebViewDelegate: 

©protocol UIWebViewDelegate <NSObject> 
©optional 

- (BOOL)webView:(UIWebView *)webView 

shouldStartLoadWithRequest:(NSURLRequest 
*)request navigationType: (UIWebViewNavigation 
Type)navigationType; 

- (void)webViewDidStartLoad: (UlWebView *)webView; 

- (void)webViewDidFinishLoad: (UlWebView *)webView; 
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Fig. 1: L'aggiunta del componente UlWebView 
alia nostra schermata 



- (void)webView: (UlWebView *)webView 

didFailLoadWithError:(NSError *)error; 

@end 



do la signature dalla documentazione, nel file 
ioProgra m mo A rt2 Vie wCo n tr oiler, m 

//file ioProgrammoArt2ViewController.m 
#import "ioProgrammoArt2ViewController.h" 
©implementation ioProgrammoArt2ViewController 
-(IBAction) gotoAddress { 

[webView loadRequest:[NSURLRequest requestWithURL 
:[NSURLURLWithString:[addressField text]]]]; 

> 

- (void)webViewDidStartLoad: (UlWebView *)webView { 



//} 



(void)webViewDidFinishLoad: (UlWebView *)webView { 



// > 



@end 

Bastera infine awiare ranimazione in un metodo 
e interromperla nell'altro: cio e reso possibile 
nella classe UIActivitylndicatorView invocando i 
due metodi, privi di parametri, startAnimating e 
stopAnimating. 

- (void)webViewDidStartLoad: (UlWebView *)webView 
{ 

[loadMonitor startAnimating]; 

} 

- (void)webViewDidFinishLoad: (UlWebView *)webView 
{ 

[loadMonitor stopAnimating]; 
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I metodi disponibili sono tutti opzionali, prowe- 
diamo quindi a implementare solo webView 
DidStartLoad, che viene lanciato quando ha ini- 
zio il caricamento di una pagina, e webViewDid 
FinishLoad che notifica il suo completamento. 
Prima dobbiamo impostare il delegate tramite 
Interface Builder, operazione che come prece- 
dentemente spiegato, awiene trascinando il 
relativo cerchietto verso il File Owner, 
Ora dobbiamo passare a XCode e modificare 
prima ilfile ioProgrammoArt2ViewController.h 

//file ioProgrammoArt2ViewController.h 

#import <UIKit/UIKit.h> 

©interface ioProgrammoArt2ViewController : 

UlViewController < UIWebViewDelegate>{ 
IBOutlet UlWebView *webView; 



IBOutlet UITextField *addressField; 



IBOutlet UIButton *goButton; 



IBOutlet UIActivitylndicatorView *loadMonitor; 



} 



@end 

aggiungendo <UIWebViewDelegate>, e successi- 
vamente creando i due metodi richiesti, copian- 



CONCLUSIONI 

Termina cosi questa serie di articoli in cui abbia- 
mo esposto alcuni dei concetti che creano mag- 
giori problemi quando si realizza per la prima 
volta un applicativo per iPhone. Nei prossimi mesi 
mostreremo il funzionamento di altri componen- 
ti visuali, e forniremo ulteriori nozioni sul linguag- 
gio Objective-C. Buona programmazione. 

Andrea Leganza 
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Fig. 2: Come si imposta il delegate 
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REAUZZIAMO UNA 
AGENDA PER IPHONE 

DA QUESTO NUMERO INIZIA UNA TRATTAZIONE CHE E UN PO' IL CUORE DI QUASI OGNI 
APPLICAZIONE IPHONE. STIAMO PARLANDO DELLE TABELLE. VEDREMO COME SI CREANO, 
QUALI TIPOLOGIE UTILIZZARE A SECONDA DEL CONTESTO, E COME GESTIRLE AL MEGLIO 




□ CD □ WEB 

ioProgrammoArt4.zip 



REQUISITI 



Conoscenze richieste 



u oop 



■A Mac OS X 10.5 o 
^ superiore 



Impegno 



Tempo di realizzazione 



000 



Uno dei componenti piu utili e utiliz- 
zati nello sviluppo di applicativi su 
'iPhone, e quello identificato dalla 
classe UITable View, una tabella a scrolling 
verticale, che consente di mostrare un elenco 
ordinato, e opzionalmente modificabile da 
parte dell'utente, di informazioni generalmen- 
te coerenti. Tale componente e praticamente 
onnipresente in ogni applicativo, e possibile 
trovarlo in numerose personalizzazioni all'in- 
terno dell' elenco dei brani audio presenti nel 
vostro dispositivo, in quello dei film, in quello 
della posta elettronica, fino all' applicativo dei 
contatti. Lo utilizzeremo prima nella versione 
fornita, creando un progetto omonimo utiliz- 
zando il wizard e prowederemo poi a custo- 
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Fig. 1: L' inter faccia che realizzeremo al termine 
della serie di articoli incentrati sulla tabella 



mizzarlo progressivamente per realizzare una 
nostra versione graficamente piu accattivante. 
II progetto che andremo a realizzare sara una 
todo list, un normale elenco di azioni da fare, 
procedura che ci consentira di analizzare in 
dettaglio la struttura di tale componente visua- 
le, oltre che a prendere confidenza con le ope- 
razioni da effettuare per gestire l'interazione 
dell'utente e la relativa modifica, sia sotto 
l'aspetto grafico, che semantico delle informa- 
zioni che andremo a presentare visivamente: 
tutto cio ci dara mo do di introdurre nuovi tipi 
di dato e di conoscere tecniche e classi fornite 
da Objective- C. 



TABELLE 

COM UITABLEVIEW 

Come viene realizzata una tabella nella pro- 
grammazione iPhone, all'interno dell' SDK? 
La classe a cui fare riferimento e quella chiama- 
ta UITableView, le cui istanze ereditano a loro 
volta dalla classe da cui questa discende diretta- 
mente: UlScrollView, tale componente consen- 
te di effettuare lo scrolling di contenuti, ed e uti- 
lizzato normalmente quando la dimensione di 
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Fig. 2: La catena di ereditarieta della classe UITable 
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tali informazioni e superiore a quella concessa 
dallo schermo dell' iPhone /iPod (320x480 pixel 
massimo, ottenibili quando non si utilizzano 
componenti visuali di navigazione, come 
UITabBarController e UINavigation Controller)] 
risulta molto utile per mostrare a video immagi- 
ni di dimensioni relativamente grandi, oppure 
per fornire un semplice sistema di navigazione 
tra schede contenenti informazioni diverse; per 
mostrare la posizione in cui ci troviamo, vengono 
utilizzate due barre di colore normalmente nero, 
identiche a quelle utilizzate nel componente uti- 
lizzato nel precedente articolo, YUIWebView. 
Rispetto a UlScrollView, UITableView aggiunge 
alcuni metodi e variabili specifiche per consenti- 
re l'interazione da parte dell'utente e per otti- 
mizzare la visualizzazione e la persona-lizzazio- 
ne, sia estetica che semantica, delle singole righe 
che vengono utilizzate per visualizzare le infor- 
mazioni fornite; proprio le righe che abbiamo 
appena citato, in questo contesto prendono il 
nome di celle (sono per tale motivo istanze della 
classe UITableViewCell) e saranno oggetto princi- 
pal di questa serie di articoli; tratteremo 
comunque in un numero successivo della rivista 
anche 1' UlScrollView. 

Poiche la classe UITableView discende, attraverso 
la classe padre, da UlView, ne eredita le caratteri- 
stiche, ed e necessario, per tale motivo, inserire 
questo componente sempre all'interno di un 
Controller o di una classe da esso derivata; oltre a 
effettuare tale pratica manualmente, utilizzando 
un qualsiasi Controller, inserendo la UITableView 
al suo interno, e gestendo la connessione tramite 
codice Objective-C [IBOutlet], e possibile velo- 
cizzare il tutto utilizzando un componente rea- 
lizzato ad hoc, discendente di UlViewController 
e chiamato UITableViewController Tale oggetto 
ha gia al suo interno una variabile, una IB Outlet 
(tenete a mente le nozioni di IBOutlet e IBAction 
perche le ritroveremo sempre d'ora in poi, 
sarebbe opportuno andare a riconsultare gli arti- 
coli precedenti nel caso riteniate di non averli 
metabolizzati) che ospitera la nostra tabella e per 
tale motivo risulta la strada piu veloce da seguire 
quando si utilizza Interface Builder, evitandoci la 
creazione di una IBOutlet apposita. Inoltre, 
essendo alia sua radice una UlView, permette di 
essere personalizzata con componenti visivi, 
quali testi, immagini, bottoni etc. Se avete modo 
di analizzare con attenzione i diversi applicativi 
disponibili nativamente con 1'iPhone /iPod 
Touch, troverete decine di varianti di questo 
componente, per non parlare delle versioni rea- 
lizzate dai programmatori che pubblicano 
sull' Apple Store! 

E probabilmente il componente piu personaliz- 
zato e utilizzato fornito dall'SDK. 



LA CREAZIONE 
DEL PROGETTO 

Per semplificare questo tutorial, utilizzeremo 
una delle voci preesistenti presenti nel wizard dei 
nuovi progetti; selezioneremo per tale motivo un 
nuovo progetto della categoria Navigation Based 
Application, che ha il pregio di essere gia configu- 
rato con una UITableView, inserita all'interno di 
un UITableViewController 

In questa circostanza non utilizzeremo la nuova 
funzionalita introdotta con l'SDK 3, chiamata 
Core Data, e, nel caso la trovaste selezionata (e 
attivabile utilizzando il checkbox che appare 
quando si seleziona questo tipo di progetto, ma 
solo se si ha aggiornato l'SDK alia versione 3) 
deselezionatela; per chi fosse curioso su cosa e 
Core Data, la risposta e semplice, e una nuova 
"funzionalita" che consente di gestire il Model 
senza dover scrivere comandi SQL per interfac- 
ciarsi con il database fornito dall'SDK: SQLITE: 
fornisce un livello di astrazione, che semplifica 
notevolmente l'utilizzo di questo database, espo- 
nendo metodi e metodologie il cui scopo e quel- 
lo di ridurre al minimo l'impegno necessario per 
gestire la memorizzazione delle informazioni, 
che possono essere non temporanee (il cui 
tempo di vita e quindi superiore al singolo utiliz- 
zo dell 'applicative) e/o quando queste sono alta- 
mente strutturate (si pensi alia memorizzazione 
di informazioni di utenti se si realizzasse un siste- 
ma di interfacciamento con un social network): 
proprio per il loro particolare utilizzo dedicheremo 
in futuro opportuno spazio. 
Quando avremo completato la fase di creazione 
del progetto troveremo alcuni file al suo interno, 
due xib (MainWindow.xib e RootViewController 
.xib) e alcune classi, tra le quali quella che ci inte- 
ressa prende il nome di RootViewController Mm. 
Cerchiamo ora di capire cosa e stato creato dal 
wizard, ma in particolar modo come e stato rea- 
lizzato.La procedura automatica ha creato un file 
xib che contiene (e conterra) tutti i nostri com- 
ponenti visuali, una superview, chiamata 
MainWindow, al cui interno viene inserito auto- 
maticamente il componente chiamato RootView 
controllerxib; questo file grafico e associato alia 
classe omonima che e un'istanza della classe 
UITableViewController. aprendo tale file all'inter- 
no di Interface Builder verra visualizzata una 
tabella perfettamente funzionante, bastera infat- 
ti eseguire il progetto nel simulatore per effettua- 
re lo scrolling utilizzando il dito. Anche se all'in- 
terno di Interface Builder, in questo caso, sono 
mostrati dei contenuti, delle citta della 
California, non bisogna preoccuparsi di elimina- 
re tali voci, andandole a cercare all'interno del 
codice del progetto, poiche queste sono sempli- 
cemente degli indicatori visivi di come potrebbe 




IPHONE 3GS 

II nuovo iPhone 3GS monta 
un processore di circa 
600MHz, 256MB di RAM, 
OpenGL ES 2, contro il 
precedente di circa 
412MHz, 128MB di RAM e 
OpenGI ES 1.1, TiPod Touch 
2G si pone nel mezzo con 
circa 533MHz e 128MB di 
RAM. 
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IBACTION 

IBAction viene 
utilizzato per identificare 
un metodo di una classe, in 
modo da notificare 
Interface Builder che tale 
blocco di codice potra 
essere invocato da un 
componente grafico; alio 
scaternarsi di uno o piu 
eventi consente, inoltre, di 
esporre tale metodo 
alllnterno di quelli forniti 
da un determinato oggetto 
visuale di IB. Cio avviene 
quando si preme il destro 
sulla relativa riga nel 
document inspector. 



apparire la vostra tabella; non bisogna pero 
tenere molto in considerazione tale anteprima, 
poiche non riflettera piu la reale visualizzazione 
della vostra tabella quando andrete a effettuare 
anche minimi cambiamenti al suo codice; se non 
effettuerete invece personalizzazioni utilizzando 
Objective-C, potrete effettuare modifiche utiliz- 
zando l'inspector (la finestra che contiene tutte 
le proprieta del componente visuale) per ogni 
modifica avra un riscontro visivo immediato, 
anche se non sempre fedele. Awiare il progetto e 
testarlo, sia nel simulatore che sul dispositivo, 
sara quindi l'unico modo per avere un riscontro 
reale dell'effettivo comportamento, e dell'aspet- 
to reale, della tabella. Purtroppo, nonostante la 
relativa semplicita del progetto, perderemo di 
vista completamente Interface Builder, poiche 
non consente di effettuare modifiche estetiche 
(se non in maniera molto limitata) e strutturali 
alia tabella: utilizzeremo d'ora in poi solamente 
codice Objective-C. 
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Fig. 3: Come sono strutturati i componenti visuali 



LE RAPPRESEIMTAZIOIMI 
DI UITABLEVIEW 

Esistono due tipi di rappresentazione grafica di 
una tabella standard: quella chiamata plain, che 
mostra un elenco semplice di righe, che d'ora in 
poi chiameremo con il nome utilizzato all'interno 
dell'SDK e della documentazione ufficiale, owero 
celle, e quella chiamata groupe, in cui insiemi di 
celle sono raggruppati in gruppi identificati da una 
stringa di testo. La prima modalita e la piu sempli- 
ce, e si presta a essere utilizzata quando non si 
desidera fornire una differenziazione tra diverse 
tipologie di informazioni mostrate a schermo, 
come per un elenco di dati appartenenti a una 
stessa tipologia, utenti di uno stesso social network 
a esempio, mentre la seconda diventa la soluzione 
logicamente, ma soprattutto graficamente, piu 
opportuna quando mostriamo a schermo diverse 
tipologie di informazioni, elencando prodotti di 
un negozio ad esempio. La seconda modalita e uti- 
lizzata anche all'interno del menu settings 
dell' iPhone, dove nella stessa schermata troviamo 



valori e comandi utilizzati per configurare diversi 
applicativi e impostazioni. 

La modalita grouped e inoltre la piu adatta quando 
si raggiunge l'ultimo livello di dettaglio delle infor- 
mazioni, quello in cui si mostrano tutti i dati 
riguardanti una determinata voce. 
Decidere quale delle due tipologie scegliere, e 
quindi un'operazione relativamente semplice, 
tenendo a mente la loro diversa funzione. 
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Fig. 4: La modalita di visualizzazione plain 



LA STRUTTURA 
DELLA UITABLEVIEW 
IN MODALITA GROUPED 

La modalita grouped merita un ulteriore 
approfondimento, poiche presenta una struttura 
particolare, la cui personalizzazione consente di 
variare il suo aspetto di default. 
Nell'immagine di Fig.5 sono mostrati tre gruppi 
con realtive intestazioni, Remote Host: www.apple. 
com , Access To Internet Hots e Access To Local 
Bonjour Hosts, ognuno di questi ha una sola cella 
associata: in questo esempio possiamo chiara- 
mente notare che viene creata una spaziatura 
sopra il gruppo chiamata padding (superiore), 
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Fig. 5: La modalita di visualizzazione grouped 
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poi troviamo uno spazio utilizzato per contenete 
V header, l'intestazione del gruppo, a cui segue la 
cella vera e propria con i suoi contenuti, seguita 
da un footer, un'area in cui e possibile inserire 
testo ad esempio e infine da un ulteriore padding 
(inferiore). E possibile personalizzate tutte que- 
ste sezioni, ma solamente utilizzando codice 
Objective-C, si inizia a comprendere come 
Interface Builder perda di utilita anche nei con- 
testi piu semplici rendendo necessario familia- 
rizzare con il linguaggio object oriented il piu 
velocemente possibile. 



COniSULTAZIOME 
MULTILIVELLO 

Quando si fornisce una lista di informazioni pre- 
sentate all'interno di una UITableView, general- 
mente si desidera rendere disponibile un sistema 
di consultazione multilivello, dove viene mostra- 
to un primo livello, nel quale viene visualizzato 
un elenco complessivo, che l'utente potra scorre- 
re, e generalmente un secondo livello di accesso a 
tali dati, nel quale si mostrano i dettagli relativi 
alia cella selezionata nel livello precedente: e lo 
stesso principio applicato nella navigazione delle 
pagine web utilizzando i menu. In realta il nume- 
ro di tali livelli e virtualmente illimitato, ma supe- 
rare di numero il valore tre/quattro crea problemi 
di orientamento all'utente che utilizza tale siste- 
ma di navigazione, molti utilizzatori non saranno 
in grado di ricordate percorsi superiori a tre inte- 
razioni e potrebbero trovare poco intuitivo tale 
approccio: il numero di utilizzi di un'informa- 
zione presente in un determinato livello si riduce 
in maniera inversamente proporzionale al nume- 
ro di tale livello: potreste scoprire con il tempo 
che, tanta fatica fatta per realizzare una determi- 
nata UlView, non e apprezzato poiche troppo in 
profondita! 
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Come detto in precedenza, quando si presenta 
l'insieme di informazioni relative all' ultimo livel- 
lo, e consigliabile utilizzare una struttura di tipo 
grouped oppure, nel caso si desiderasse una strut- 
tura piu complessa, una UlView {UlScroll View o 
simili) opportunamente strutturata. 



GLI IMDICATORI 
DI DETTAGLIO 

Quando si realizza una struttura multilivello e 
necessario informare visivamente l'utente se esi- 
ste un successivo livello di navigazione cliccando 
su una determinata cella oppure no. Per tale 
motivo sono disponibili due icone per rappre- 
sentare la disponibilita di un maggiore dettaglio 
per 1'informazione selezionata, e che vengono 
posizionate all'estrema destra delle singole celle. 
Una di queste, ottenibile impostando il tipo di 
cella come un UITableViewCellAccessory Disclo 
sure- Indicator, e la cui immagine e una freccia 
verso destra, simile al simbolo di maggiore di 
colore grigio (>) chiamata Dislosure Indicator, 
informa che il prossimo livello generalmente 
conterra un'altra tabella (con maggiore detta- 
glio), e un'altra, UITableViewCellAccessory Detail- 
DisclosureButton, chiamata Detail Disclo sure 
Button, identificata da un cerchio celeste con lo 
stesso simbolo di >, ma di colore bianco, che in 
questo caso indica che il prossimo livello dovreb- 
be essere quello finale; nessun controllo automa- 
tico vieta di agire in maniera diversa, realizzando 
diverse strutture con questi simboli, ma e alta- 
mente sconsigliato per evitare di non andare 
contro le regole di usabilita dettate dalla ditta di 
Cupertino che potrebbero impedire l'accet- 
tazione del vostro software per la vendita 
sull'Apple Store (e capitato a numerosi utenti): il 
consiglio e quindi quello di essere fedeli al com- 
portamento standard quando si utilizzano sim- 
boli e i componenti forniti dall'SDK. 
Owiamente l'assenza di uno o dell'altro simbolo 
implica la mancanza di alcuna schermata suc- 
cessiva alia presente, e per tale motivo dimostra- 
zione di scarsa attenzione non utilizzarli quando 
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PLAIN E GROUPED 

La tabella di tipo plain s\ 
presta per elenchi generici, 
mentre quella grouped 'per 
rappresentare le 
schermate di dettaglio, 
oppure quando le 
informazioni mostrate sono 
raggruppate per una o piu 
caratteristiche comuni. 



Fig. 6: Le diversa gestione degli spazi presente 
quando una tabella e del tipo grouped 



Fig. 7: Un esempio di navigazione a tre livelli. 
Le informazioni sono sempre piu dettagliate 
con il progredire del numero di livello 
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ILSISTEMA 
Dl NAVIGAZIONE 
MULTILIVELLO 

Qualunque utilizzo di un 
applicativo iPhone e 
pensato o come lo sfogliare 
un libra, muovendosi 
parallelamente, oppure 
come navigare all'interno 
di un sito web, ottenendo 
informazioni sempre piu 
dettagliate man mano che 
si scende in profondita 



necessario. E inoltre disponibile una terza icona, 
generalmente utilizzata quando si effettuano 
selezioni singole o multiple, quando si scelgono, 
ad esempio, diversi prodotti: e il simbolo di 
spunta ( UITableViewCellAccessoryCheckmark) 
chiamato Check mark. Se questi sono i simboli 
piu utilizzati, nessuno vieta, comunque, di per- 
sonalizzarli a proprio piacimento, inserendo 
immagini create con il proprio programma di 
illustrazione preferita, renderete piu accattivante 
e personale la vostra applicazione, evitando di 
farla sembrare troppo anonima e poco di impat- 
to; conviene comunque utilizzare simboli di 
immediata comprensione per non confondere 
l'utente, evitando, ad esempio, di utilizzare frec- 
ce con verso illogico o immagini poco intuitive. 



TIPOLOGIE DI CELLE 

SDK 3.0 ha aggiunto un'utile proprieta per impo- 
stare il tipo di visualizzazione predefinita da uti- 
lizzare per le celle, nel caso non si volesse realiz- 
zare una propria versione. 
Precedentemente era necessario posizionare i 
componenti visuali, utilizzando chiamate 
Objective-C, un'operazione che di ripeteva spesso 
in numerosi progetti, in questo modo si risparmia 
molto tempo, e si evita di incorrere in problemi di 
allineamenti e trasparenze errati. 
Gli stili di visualizzazione sono i quattro seguenti: 
UITableViewCell StyleDefault, UITableViewCell 
StyleSubtitle, UITa bleViewCellStyleValuel, UITable 
ViewCellStyleValue2. II primo tipo consente 
l'inserimento di un'immagine sulla sinistra della 
cella, un testo e un opzionale simbolo di dettaglio, 
il secondo aggiunge una didascalia sotto alia voce 
principale, mentre gli ultimi due sono solo elenchi 
testuali, non consentendo l'inserimento di alcuna 
immagine. II testo principale e accessibile tramite 
la proprieta textLabel, mentre quello piu piccolo 
utilizzando quello detailTextLabel 
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Fig. 8: I quattro tipi predefiniti di celle disponibili dalla versione 3.0 dell 'SDK 



Ogni tabella, istanza di UITableView, ha bisogno di 
essere associata a due altre istanze, di qualunque 
classe; infatti, controllando l'API, noterete che e 
utilizzato in entrambi i casi l'identificatore id, 
sinonomio di "qualunque oggetto"; una istanza 
sara responsabile di fornirle i dati da mostrare a 
schermo, e viene identificata dal Data Source 
(Model del pattern MVC), e un'altra prowedera 
a gestire aspetto e comportamento (View e 
Controller del pattern MVC): non e necessario 
che queste due istanze siano diverse, infatti, in 
progetti non molto strutturati, si preferisce farli 
combaciare; tale comportamento viene inoltre 
seguito dal wizard stesso, che infatti ha prowe- 
duto automaticamente ad associare le due pro- 
prieta alia nostra istanza di RootViewController: 
bastera andare in Interface Builder, premendo il 
tasto destro del mouse sul File Owner per verifi- 
care tale affermazione. Da parte sua la 
UITableView creata riveste il ruolo per il 
RootViewController di View e di proprieta 
tableView. Si e realizzato quindi un ciclo di 
dipendenze. UITableView interroghera i due 
delegati per effettuare tutte le operazioni, sia 
automatiche che scatenate dall'interazione del- 
l'utente e su come presentare il proprio aspetto e 
quello delle celle. Data Source utilizza il proto- 
collo UITableViewDataSource, mentre il delegato 
il UITableViewDelegate; nel primo caso si richie- 
de al delegato, in questo caso il file 
RootViewControllerh/.m, di essere interme- dia- 
rio tra la tabella e il model, fornendo su richiesta 
le informazioni necessarie e consentendo il loro 
inserimento, modifica e/o cancellazione. 
UITableViewDelegate, invece, e responsabile di 
fornire informazioni alia tabella su quale e 
1' aspetto delle celle e di come gestire 
l'interazione con l'utente, ed anche in questo 
caso coincide con RootViewControllerh/.m; i 
metodi disponibili sono decine e la documenta- 
zione disponibile e la fonte piu adatta. 



IL PROCESSO DI 
CREAZIOME DELLE CELLE 

II procedimento necessario per la creazione di 
tutte le celle e relativamente semplice: la tabella 
interroga il proprio delegato, UITableViewData 
Source, richiedendo il numero di celle, sinonimo 
di righe, rows, utilizzando il metodo numberOf 
RowsInSection, per poi popolare le celle iterativa- 
mente invocando il metodo cellForRow 
AtlndexPath. Se non viene specificato, come 
awiene in questo esempio il numero di gruppi 
disponibili, identificati dal termine sections, e 
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Fig. 9: La tabella richiede il numero di righe e il numero 
di sezioni che la stessa deve ospitare 



ottenuto dalla tabella invocando sul delegate il 
metodo opzionale sectionlndexTitlesForTableView, 
tale valore e assunto come unitario e non verran- 
no visualizzati header/ footer e relative spaziatu- 
re. II metodo cellForRowAtlndexPath svolge 
quindi tutto il lavoro necessario per la generazio- 
ne del componente visuale che verra utilizzato 
per la tabella: 

- (UITableViewCell*) tableView:(UITableView*) 
tableView cellForRowAtlndexPath :(NSIndexPath *)indexPath 

riceve per tale motivo come parametri la tabella, 
e le coordinate della cella, contenuti nella varia- 
ble indexPath, che nella sua versione piu sem- 
plice fornisce solo la riga richiesta, nel caso di un 
semplice array monodimensionale, ma quando 
si utilizzano strutture dati piu ramificate, questa 
e caratterizzata da numerosi indici (ad esempio 
1.4.5), come awiene per i paragrafi di un libro, 
alio scopo di identificare univocamente la posi- 
zione delle informazioni richieste. 
Tale metodo crea il componente visuale, 
un'istanza della classe UITableViewCell , figlia di 
UlView, configurandola attraverso l'inserimento 
di oggetti visuali, immagini e testi inclusi, richie- 
dendo le informazioni al model (array o altra 
struttura dati): e qui che generalmente viene 
scritta la maggior parte del codice, anche se, di 
recente, con l'aggiunta dei tipi di celle predefini- 
ti, fornita dall'SDK 3, si e notevolmente ridotta. 
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Fig. 10: La Tabella utilizza il file RootViewController 
come delegate per entrambi i protocolli 



MIGLIORARE 

LE PERFORMANCE 

Quando effettuate lo scrolling della tabella con un 
numero superiore a qualche decina, noterete ini- 



zialmente una fase di rallentamento iniziale, che 

successivamente non si presentera. 

Tale comportamento e dovuto alia necessita da 

parte del sistema di effettuare caching delle celle 

mostrate. 

Nel caso andaste a visualizzare decine di celle 
in una sola schermata, potrete avere comun- 
que fenomeni di rallentamenti, enfatizzati se 
avete personalizzato le vostre celle, aggiungen- 
do immagini, testi, pulsanti, o altre UlView; 
cio dipende da come gestirete i contenuti pre- 
senti all'interno della singola cella; preferite 
quindi contenuti senza trasparenza, ottenuti 
impostando la proprieta di opacita tramite 
Objective- C utilizzando nomevar labile. opaque 
- YES o tramite IB selezionando il checkbox 
Opaque (quando possibile). 
Tale accorgimento consente di migliorare, 
spesso in maniera evidente, il rendimento a 
video durante la fase di scrolling: ridurre al 
minimo gli oggetti visuali trasparenti e quindi 
una buona operazione che non dovrebbe esse- 
re effettuata nella fase finale dello sviluppo; 
inserire, come e stato detto, un certo numero 
di oggetti, pulsanti, campi di testo e/o immagi- 
ni, in una cella ne degrada le performance: in 
tal caso una soluzione consiste nel rasterizza- 
re, convertendo quindi in immagine, l'intero 
contenuto della cella che si vuole mostrare a 
schermo, e inserire solamente questo all'inter- 
no della stessa; in questo modo si migliorera 
notevolmente la prestazione complessiva del 
vostro software. 

Un ulteriore accorgimento pub essere quello di 
non creare una tabella per ogni livello di detta- 
glio, ma di modificare ogni volta sempre la 
stessa, in modo da ridurre al minimo il dispen- 
dio di risorse. II nuovo iPhone 3GS, ha al suo 
interno un processore con circa 200 MegaHertz 
in piu rispetto alia precedente versione, cio 
significa un incremento effettivo di prestazioni 
comunque evidente, con relativo aumento di 
velocita di risposta nelle piu comuni operazio- 
ni, testare quindi il vostro gioco o applicativo 
solo su tale dispositivo potrebbe essere un 
grande errore, poiche il numero di iPhone 
3G/2G e al momento maggiore rispetto a quel- 
lo di esemplari del nuovo modello: cercate di 
testare anche su uno dei due precedenti, in 
caso non risultasse notevolmente lento anche 
su questi dispositivi ne trarrete sicuramente 
vantaggio, sia di feedback positivi ottenuti 
dagli acquirenti, che di download, e in caso di 
vendita, di guadagni, perche owiamente rag- 
giungerete un numero piu cospicuo di utenti 
interessati al vostro progetto.. 
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IPHONE: GESTIONE 
DELLA MEMORIA 

PER CHI SI ACCINGE A SVILUPPARE APPLICAZIONI PER LO SMARTPHONE Dl CASA APPLE, 
UNO DEGLI ARGOMENTI SICURAMENTE PIU OSTICI, E LA GESTIONE DELLA MEMORIA. 
IN QUESTO ARTICOLO AFFRONTEREMO PROPRIO QUESTA IMPORTANTE TEMATICA 





□ CD □ WEB 

ioProgrammoAit4.zip 



REQUISITI 



Conoscenze richieste 



u 00p 



MacOSX 10.5.4 o 
superiore, XCode 



Impegno 



0000' 



Tempo di realizzazione 



Nell'articolo precedente abbiamo descritto la 
struttura, intesa come insieme di componenti 
visuali, che viene creata automaticamente 
quando realizziamo, attraverso 1'utilizzD nel wizard, un 
progetto del tipo Navigation-Based Application; e 
stato inoltre introdotto il componente chiamato 
UITableView e le relazioni che si instaurano tra la 
popolazione delle celle (sinonimo di righe della 
tabella) e il metodo cellForRowAtlndexPath, che, 
come spiegato, svolge tutto il lavoro necessario 
per la generazione di tali componenti visuali 
aU'interno del delegate. Analizzeremo tale meto- 
do in maniera dettagliata, in modo da introdurre 
alcune caratteristiche del linguaggio Objective-C 
che, potremo affermare senza alcun dubbio, esse- 
re le piii importanti, e anche piii impegnative da 
comprendere: per tale motivo e vivamente consi- 
gliato testare personalmente i vari aspetti trattati 
in queste pagine per metabolizzarli correttamen- 
te. 



NIL, NIL, NULL 
E niSHIULL 

Ogni istanza di un oggetto, quando viene definita (il 
suo stato interno non e quindi ancora stato inizia- 
lizzato) assume automaticamente valore nil (ad 
esclusione di isa che assume la struttura della classe 
di cui la variabile e istanza); in ambito Objective-C 
ra'/indica che una variabile (che dovrebbe puntare a 
un'istanza di un oggetto) non punta ad alcuna loca- 
zione di memoria. NULL, familiare a chi program- 
ma in C, e anche disponibile nel linguaggio 
Objective-C, owiamente questo e dovuto al fatto 
che tale linguaggio e una versione opportunamente 
modifica del C. nil viene quindi utilizzato per i pun- 
tatori ad oggetti, mentre NULL per qualunque pun- 
tatore (esistono ad esempio quelli a funzioni); 
entrambi, comunque, se andiamo ad analizzare la 
loro effettiva semantica, assumono valore pari a 
{void*)0. 

#ifndef NULL 



#define NULL 



DARWIN NULL 



#endif /* ! NULL */ 



#ifndef nil 



#define nil NULL 



#endif 

Se utilizzerete sempre Objective-C incontrerete 
molto raramente NULL, a meno di accedere ad 
alcune funzionalita particolari, che generalmente 
scendono a livelli piu bassi, in linguaggio C puro, 
quindi, e comunque necessario essere a conoscen- 
za della differenza tra i due e dei diversi contesti in 
cui li potete incontrare. Nil, con la prima lettera 
maiuscola, e utilizzato per i puntatori a classi, e per 
tale motivo lo troverete ancora piu raramente, poi- 
che generalmente viene utilizzato lo stesso nil 
(sono anche questi sinonimi dal punto di vista sin- 
tattico). 

NSNULL e presente invece in quelle classi che 
fanno parte della Foundation collection {NSArray, 
NSSet, NSDictionary e altre) poiche queste non 
possono contenere il valore nil . Se vogliamo veri- 
ficare che un oggetto e appena stato creato, ma 
non ancora inizializzato, possiamo effettuare il 
seguente controllo: 

if (myObject= = nil) 

{ 

//inizializzazione 



} 



Sarebbe ideale effettuare tale controllo prima di 
ogni utilizzo di una variabile, ma risulterebbe 
dispendioso sia in termini di memoria/ risorse sia 
per numero di righe di codice, conviene quindi uti- 
lizzarlo in quelle situazioni in cui si e dubbiosi 
sullo stato di una variabile, ad esempio quando 
questa viene creata in un metodo e utilizzata in un 
altro, e spiegheremo a breve perche tale tecnica 
pub risultare di fondamentale utilita. 
Inoltre, invocare qualunque metodo su tale varia- 
bile restituisce sempre 0 (in realta quasi sempre 
,ma non ci addentriamo troppo) e viene quindi 
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interpretato come false nei controlli condizionali, 
if, else, while etc. 

A differenza del linguaggio C, in cui invocare su 
una variabile NULL generalmente causa un crash 
dell' applicative in questo contesto si ottiene inve- 
ce sempre un risultato da tali chiamate, anche se 
poi inutilizzabili nella pratica, oltre che sintomo di 
scarsa comprensione del funzionamento del lin- 
guaggio, e causa di dispendio di risorse, anche se 
modestissimo, ma che in un dispositivo con risor- 
se relativamente limitate pub fare la differenza, 
dovuto alio scatenarsi di tutto il sistema di invoca- 
zione del metodo relativo (anche se inesistente); e 
quindi perfettamente lecito effettuare la seguente 
chiamata: 

NSString miaStringa; 
miaStringa = nil; 

[miaStringa isEqualTo:altraStringa]; 

Spesso, proprio utilizzare una variabile che assu- 
me il valore nil come parametro di un metodo, sca- 
tena una serie di problematiche che generalmente 
terminano con un crash del sistema: sono la causa 
piu frequente di problemi quando si programma 
con tale linguaggio e per evidenziare tali situazioni 
e necessario generalmente utilizzare il debugger 
fornito, che, come scopriremo in un prossimo arti- 
colo, e "semplicemente" il famoso gdb, provenien- 
te direttamente dall'ambiente GNU /Linux (ma 
non solo). 

E possibile assegnare in qualunque momento nil 
quale valore di una variabile, ma in tal caso e'e il 
rischio di non rilasciare le opportune risorse asso- 
ciate a tale istanza (situazione identificata con il 
termine leak), 

//effettuare prima la deallocazione delle risorse 

associate alia variabile myObject. 

myObject= = nil 

//qualunque chiamata successiva non avra alcun 

risultato 

//Non effetturare tale operazione se la variabile 

non e stata deallocata opportunamente!!! 



> 



le motivazioni di tale affermazione verranno spie- 
gate successivamente, quando si introdurranno i 
concetti relativi alia gestione della memoria. 
Per concludere questa sezione e opportuno ricor- 
dare che esistono altri valori che assumono valore 
0, ma utilizzati in contesti prettamente grafici: 
NSZeroPoint (un punto di coordinate 0,0). 
NSZeroSize (una dimensione NSSize di larghezza e 
lunghezza 0) e NSZeroRect (un rettangolo NSRect 
posizionato nell'origine di di larghezza e lun- 
ghezza 0); 



IL METODO 

CELLFORROWATIMDEX 
PATH 

Dopo aver descritto cos'e nil troverete sicura- 
mente piu semplice la lettura del codice del 
metodo cellForRowAtlndexPath, che qui per 
chiarezza presentiamo nella versione prodotta 
direttamente dal wizard: 

- (UITableViewCell *)tableView:(UITableView 

*)tableView cellForRowAtlndexPath : 

(NSIndexPath *)indexPath { 

static NSString *CellIdentifier = @"Cell"; 

UITableViewCell *cell = [tableView 
dequeueReusableCellWithldentifienCellldentifier]; 

if (cell == nil) { 

cell = [[[UITableViewCell alloc] 

initWithStyle:UITableViewCellStyleDefault 
reuseldentifienCellldentifier] autorelease]; 

} 

// Configurazione della cella 



return cell; 



} 



Generalmente, una tabella ottiene i dati da una 
struttura dati, un array ad esempio, in ambiente 
Objective-C identificato dalla classe NSArray, e 
dovra mostrare, a meno di particolari condizioni, 
come un semplice filtraggio effettuato in una 
ricerca, tutti gli oggetti in essa contenuti e utiliz- 
zare i valori di ogni singola istanza per popolare 
le celle della tabella: se ogni oggetto conterra al 
suo interno una stringa, potremo utilizzare tale 
variabile per mostrare nella cella un testo visibile 
all'utente che scrollera la tabella. 
Quando la tabella, come e stato spiegato 
approfonditamente nell'articolo precedente, 
richiede al proprio delegate la struttura delle sin- 
gole celle, operazione che awiene invocando il 
metodo suddetto, effettua sempre alcune opera- 
zioni, obbligatorie, e presenti nel metodo 
cellForRowAtlndexPath prodotto dal wizard: 
viene creato un certo numero di celle (grafica- 
mente parlando), che non corrisponde al reale 
numero di oggetti presenti nella struttura dati: 
quando verra effettuato lo scrolling della tabella 
tali celle verranno riutilizzate e ne verranno cam- 
biati i valori interni, nel nostro caso, quindi, 
(ricordiamo che stiamo progettando un'appli- 
cazione agenda), l'azione da effettuare per una 
certa giornata: questo procedimento e stato 
ideato per ottenere un notevole risparmio di 
risorse, si pensi che cosa succederebbe se si 
creassero tutte le istanze delle celle anche quan- 
do l'utente non le visualizza: quasi ogni applica- 
tive verrebbe chiusa per saturazione della 
memoria disponibile nel dispositivo. Con questa 
tecnica viene risolto questo possibile collo di 
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ULTERIORI 
APPROFONDIMENTI 

Per approfondire i concetti 
mostrati in questo articolo, 
consultare la guida 
chiamata Memory 
Management Programming 
Guide for Cocoa disponibile 
su sito 

developer.apple.com o 
all'interno della 
documentazione fornita con 
Xcode 



bottiglia in maniera molto intelligente; quella 
descritta non e comunque una tecnica presente 
solo in tale linguaggio: prende il nome di UI 
Virtualization, ed e possibile ritrovarla, ad esem- 
pio, anche in Adobe Flex 4 per il nuovo compo- 
nente DataGroup {Spark) , e in Windows 
Presentation Foundation per il componente 
DataGrid fornito nel WPF Toolkit. La variabile sta- 
tica cellldentifier viene creata solamente durante 
la prima invocazione del metodo e permette di 
identificare la tipologia di cella che stiamo crean- 
do, utilizzando una stringa, che in questo caso 
corrisponde al valore "Cell"; nessuno vieta di crea- 
re diverse celle con diverse caratteristiche e deci- 
ders a seconda delle necessita, quale utilizzare 
per un determinato oggetto prelevato dalla nostra 
struttura dati. 

Se volessimo quindi avere due celle diverse per 
qualche caratteristica, basterebbe effettuare la 
seguente operazione: 

static NSString * CellldentifierWhiteBackground = 

@"Cell"; 

static NSString *CellIdentifierBlackBackground = 

@"CellBlackBackground"; 

if (decisioneCellaNormale) 
UITableViewCell *cell = 

[tableView dequeueReusableCellWithldentifienCelll 

dentifierWhiteBackground]; 

{ 

//codice di formattazione grafica e 

popolazione della cella 



} 



else //decisioneCellaBlackBackground 
UITableViewCell *cell = [tableView dequeueReusable 
CellWithIdentifier:CellIdentifierBlackBackground]; 



{ 



//codice di formattazione grafica e 

popolazione della cella 



} 



return cell; 

Potremo inoltre conoscere il tipo di cella richia- 
mando la proprieta (di cui parleremo successi- 
vamente in maniera approfondita, per ora iden- 
tificatela come una variabile pubblica, accessi- 
ble quindi dall'esterno della classe) current- 
Cell, reuseldentifier che restituira la stringa uti- 
lizzata (nel nostro esempio corrispondente a Cel- 
IWhiteBackground oppure CellBackBackground) . 
Proseguendo notiamo che prima viene verifica- 
to che non esiste gia una cella con l'identificatore 
che abbiamo deciso ("Cell") , in caso non sia sta- 
ta gia creata viene invocato il costruttore della 
cella, utilizzando lo stile UITableViewCellStyle- 
Default (spiegato nell' articolo precedente) e ta- 
le istanza viene inserita nella Autorelease Pool. 



GESTIONE DEGLI OGGETTI 

Queste regole sono i concetti fondamentali che 
devono essere sempre tenuti in considerazione 
durante lo sviluppo di qualunque applicativo, ven- 
gono introdotti solo ora perche negli articoli prece- 
denti non erano utilizzati quegli aspetti del lin- 
guaggio che potevano indurre confusione e gene- 
rare crash, inoltre si e alleggerito il contenuto del 
primo tutorial : 

• Un oggetto puo essere utilizzato da uno o piu 
proprietari (altri oggetti); 

• quando un oggetto non ha proprietari, viene 
distrutto automaticamente senza alcun 
preawiso e in un momento imprecisato 
durante l'esecuzione del vostro applicativo 
dalT Autorelease Pool, generalmente dopo l'uscita 
dal metodo in cui e stato creato; 

• per impedire la sua distruzione automatica si 
deve notificare l'Autorelease Pool che si e 
divenuti proprietari di tale oggetto (utilizzando 
il metodo retain); 

• se non si e piu interessati a tale oggetto, si 
deve smettere di esserne proprietari 
(utilizzando i metodi release/ autorelease) 
per consentirne una possibile distruzione da 
parte dell'Autorelease Pool; 

• il numero delle dichiarazioni di appartenenza 
[retain) deve essere bilanciato con quello dei ri- 
lasci [release) in modo da consentire il rilascio 
automatico; 

• il numero di dichiarazioni di utilizzo viene 
chiamato retainCounte assume superiori o 
uguali a 0, in caso assuma quest' ultimo verra 
deallocato dall' Autorelease Pool; 

• quando si raggiunge una certa esperienza e 
opportuno utilizzare il piu possibile alloc/re 
tain/release invece di utilizzare autorelease, 
per motivi prestazionali, soprattutto all'inter- 
no di cicli con un numero consistente di ite- 
razioni; 

• il sistema invia un awiso di risorse insufficien- 
ti (principalmente RAM) quando questa decre- 
sce raggiungendo un valore prossimo ad 1.5MB. 

Se la prima regola e un concetto condiviso da 
tutti i linguaggi Object-Oriented (e non solo), 
ed e quella che consente di condividere una 
variabile tra piu istanze di una o piu classi, ana- 
lizzando le altre si puo intuire che esistono due 
metodologie per gestire la memoria occupata 
da una variabile, una automatica (Autorelease 
Pool) e una manuale (alloc/retain/release) dove 
e responsabilita del programmatore gestire il 
tutto; non sempre la modalita automatica 
risponde alle esigenze di sviluppo e per tale 
motivo entra in gioco la seconda. 
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AUTORELEASE POOL 

L'Autorelease Pool nasce come necessita, in 
ambiente Objective-C di fornire un sistema auto- 
matico di rilascio delle risorse non utilizzate, che 
molti potrebbero identificare con il sistema di 
Garbage Collection (GC) presente in numerose 
VM, Java e .NET in primis; poiche nel dispositivo 
Apple non viene eseguito un vero motore di GC, 
principalmente per motivi prestazionali e di 
occupazione di risorse, quando awiamo i nostri 
applicativi (ricordo che alia fine sono scritti in 
linguaggio C) questa e la soluzione automatizza- 
ta che ci viene fornita. 

Come funziona l'Autorelease Pool? Tale compo- 
nente e identificabile come un analizzatore di 
istanze di oggetti sulle quali e stato invocato il 
metodo autorelease, sono stati quindi identifica- 
ti come oggetti il cui ciclo di vita viene deciso 
dall'Autorelese Pool stesso; questo prowede a 
liberare la memoria, distruggere quelle istanze di 
oggetti non piu necessari, in maniera automati- 
ca, analizzando una particolare proprieta chia- 
mata retainCount (un variabile numerica pre- 
sente in ogni istanza il cui funzionamento verra 
spiegato a breve) : quando trovera questa pari al 
valore 0. L' autorelease pool invoca sulla variabile 
un metodo, che viene identificato come il suo 
distruttore, chiamato dealloc, nel quale si effet- 
tuano generalmente operazioni di rimozione di 
legami con altre variabili (utilizzando il comando 
release/ dealloc spiegati in seguito) . 
Durante il ciclo di vita di una variabile, il 
retainCount viene quindi incrementato e decre- 
mentato, fino generalmente a terminare in un 
determinato istante t } in cui questo assumera 
valore 0: non e detto che si raggiunga tale valore 
durante l'utilizzo del software, e ammissibile che 
una variabile abbia retainCount superiore a 0 per 
tutta la sua esistenza, e termini la sua vita alia 
chiusura dell' applicative. 

L'operazione di rilascio automatico awiene in 
maniera non prevedibile e non e possibile quin- 
di sapere quando viene effettuata in maniera 



retain count: 1 








istanza_l 




retain count: 2 




istanza_2 


j autorelease 


retain count: 0 




istanza_3 ' 






[istanza_3 dealloc]; 



Fig. 1: L'Autorelease pool distrugge le istanze delle 
classi con retainCount pari a 0 automaticamente, invo- 
cando su di esse il metodo deallocf) 



automatica, a meno di notificare tale evento uti- 
lizzando le stampe a schermo all'interno del 
metodo dealloc, generato automaticamente in 
ogni classe da parte del wizard; questa operazio- 
ne e realizzabile semplicemente aggiungendo 
una stampa a schermo prima dell'invocazione 
del metodo distruttore sulla classe padre: 

-(void) dealloc { 
N S Log (@ "Istanza deallocata"); 
[super dealloc]; 
T~ 

In questo modo, osservando la finestra di log 
quando si awia un applicativo in modalita di 
debug, si avra modo di sapere con una certa pre- 
cisione quando un'istanza viene deallocata. 
Spesso, quindi, una variabile impostata per 
l'autorilascio {autorelease) che si utilizzava senza 
problemi durante l'esecuzione del proprio appli- 
cativo, in numerosi metodi nei quali si presuppo- 
neva, erroneamente, che non sia stata mai deal- 
locata, a un successiva esecuzione dello stesso 
potrebbe causare in crash il sistema dopo alcuni 
secondi, o anche minuti; cosa e accaduto? Nel 
primo caso il pool non ha effettuato pulizia 
durante l'utilizzo, mentre nel secondo caso ha 
proweduto a deallocarla automaticamente. 
Quando invochiamo autorelease su un oggetto 
richiediamo il decremento del suo retainCount 
di un'unita in un momento futuro, se questo 
scendera a 0 ci sara il conseguente rilascio auto- 
matico. Se andiamo ad analizzare il contenuto 
del file main.m, generato automaticamente in 
ogni progetto dal wizard, troverete il seguente 
codice: 

NSAutoreleasePool * pool = [[NSAutoreleasePool 

alloc] init]; 

int retVal = UIApplicationMain(argc, argv, nil, nil); 
[pool release]; 

La prima riga crea e inizializza 1' autorelease 
Pool, che identifichiamo come Main Autorelease 
Pool, cioe autorelease pool principale, successi- 
vamente, nella seconda riga, viene awiato il 
nostro applicativo , e nella terza viene invocato il 
metodo release su tale pool. 
Tutto cio che e contenuto tra la riga di creazione del 
pool e la chiamata del metodo release viene gesti- 
to da tale oggetto. E possibile creare uno o piu re- 
lease pool al di fuori del Main Autorelease Pool 
per rispondere a determinate esigenze? Certo, an- 
che se i contesti in cui fatta questa scelta sono par- 
ticolari, generalmente comunque ci si affida al Au- 
torelease Pool principale, l'utilizzo piu frequente 
realizzato in maniera manuale da un program - 
matore, e quello di realizzarne una versione ad 
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hoc all'interno di un ciclo nel quale vengono generate 
decine, se non centinaia o addirittura migliaia, di 
variabili temporanee ma viene sconsigliato in am- 
biente iPhone perche introduce un sovraccarico 
computazionale che in alcune situazioni potreb- 
be obbligare il sistema a terminare la vostra ap- 
plicazione. 



V 



AUTORELEASE POOL 



Autorelease Pool provvede in 
maniera automatica e 
trasparente a rilasciare la 
memoria allocata per un oggetto 
in un non precisato momento 
durante I'esecuzione del vostro 
applicativo. Ogni istanza su cui 



non viene invocato il metodo 
alloc (ma anche , allocWithZone:, 
copy, copyWithZone:, 
mutableCopy, 

mutableCopyWithZone o retain, 
viene gestita da tale oggetto 
automaticamente. 



RIFERIMENTI WEB 

Creazione dell'account, per 
scaricare I'SDK 
gratuitamente e consultare 
la documentazione: 
http://developer. 
apple.com/iphone/ 



Un utilizzo generalmente piu comune e quando si 
utilizzano i thread e si rende necessario creare una pool 
locale a tale ambiente di esecuzione. L'operazione di 
pulizia viene generalmente forzata quando le risor- 
se di sistema scendono sotto alcunilimiti, se si veri- 
ficano tali condizioni inoltre viene invocato per ogni 
UlViewController (e relative classi) il metodo didRe- 
ceiveMemoryWarning, nel quale si dovrebbe prov- 
vedere alia rimozione manuale di quelle istanze non 
strettamente necessarie e non gestite dall'Atorelea- 
se Pool. E obbligatorio invocare il metodo autore- 
lease su una variabile per affidarla alia gestione del- 
l'Autorelease Pool? No, tale operazione viene effettuata 
ogni volta che viene creata una variabile senza utilizzare 
il metodo alloc; 

-(void) inizializzazione { 

NSString *newText = [NSString stringWithFormat 

@"Lavoro da fare."]; 
//autorelease automatico, retainCount scendera da 1 
a 0 in un non precisato istante dopo la fine del 

metodo; 

//area di utilizzo dellavariabile 
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//al tempo t (random) dopo I'uscita dal metodo verra 
deallocata automaticamente 

Questo tipo di inizializzazione, fornito da NSString, 
utilizando uno dei suoi cosiddetto Factory Methods 
(metodi statici che generano su richiesta istanze 
della classe), permette di utilizzare la variabile 
all'interno del metodo in cui questa viene creata e 
verra rilasciata, in un non precisato momento, 
quando tale metodo terminera, cio awiene perche 
quando inizializziamo newText questa assume 
retainCount 1 e, alia prossima analisi da parte 
dell'Autorelease Pool, verra deallocata poiche, 
essendo autorelease, subira un decremento auto- 
matico di tale valore di 1. Questo utilizzo general- 
mente non causa problemi, perche la deallocazio- 
ne automatica da parte dell' autorelease Pool awie- 
ne sempre tra una chiamata e l'altra di un metodo; 
e un approccio comunemente utilizzato quando si 
utilizzano cicli {while e for ad esempio) in cui si 
creano numerose variabili, ma si desidera che ven- 
gano rimosse automaticamente quando non piu 
necessarie (in alcune situazioni non e la soluzione 
migliore in termini prestazionali, quindi e necessa- 
rio utilizzare la modalita "manuale" adoperando 
quindi alloc/retain/release. Se definissimo una 
variabile esternamente al metodo, per poi inizializ- 
zarla al suo interno per un utilizzo in uno o altri 
metodi in istanti successivi, verrebbe gestita tale 
situazione dall'Autorelease Pool? 

NSString * newText; 
-(void)inizializzazione { 



newText 



} 



[NSString stringWithFormat 

@"Lavoro da fare."]; 



-(void)mostraVariabile{ 



N S Log ( @ "% @ ", n e wText) ; 



Fig. 2: Un esempio fornito dalla stessa Apple sul funzionamento dell'Autorelease Pool 



} 



Invochiamo il metodo inizializzazione per inizia- 
lizzare la nostra variabile e poi, invochiamo in altri 
metodi quello chiamato mostraVariabile, notere- 
mo che casualmente, otterremo dei crash del siste- 
ma: cio e dovuto al fatto che 1' autorelease Pool ha 
rilasciato la variabile tra due successive chiamate 
di mostravariabile (Fig.3): ecco uno dei motivi piu 
frequenti di crash della applicazioni su iPhone: 
assumere che una variabile sia sempre disponibile 
quando creata! Le regola, la ribadiamo, e la 
seguente: "se nella creazione della variabile non 
viene usato alloc oppure retain, come vedremo 
successivamente, tale variabile verra rimossa in 
maniera casuale e senza alcuna prevedibilita", 
memorizzate bene questo concetto perche altri- 
menti passerete intere giornate cercando di capire 
perche il vostro applicativo crasha casualmente. 
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Fig. 3: L'Autorelease distrugge newText tra 
un'invocazione e un'altra di mostraVariabile, generando 
un crash 



Come evitare questo problema di autorilascio? Un 
primo modo e quello di utilizzare retain, in modo 
da notificare all'Autorelease Pool che vogliamo uti- 
lizzare tale variabile e che siamo in prima persona 
responsabili del suo rilascio, siamo quindi diventa- 
ti quindi uno dei co-proprietari di tale variabile; il 
secondo consiste nel creare una variabile utiliz- 
zando alloc, metodo che spiegheremo nel prossi- 
mo articolo. Questo problema di accesso, dovuto a 
una scarsa comprensione della gestione in questo 
contesto, e probabilmente uno dei motivi piu fre- 
quenti di crash quando si programma per i dispo- 
sitivi di casa Apple. 



V 



Moltissime classi hanno un prefisso NS, 
questo e dovuto al fatto che Mac OS X ha 
radici in NeXTSTEP, (di cui NS 
rappresentano le iniziali) linguaggio 
realizzato utilizzando Rhapsody e Mac OS, e 
che identifica storicamente molte delle 
classi che fanno parte delle API utilizzate 
per lo sviluppo su Mac. 



SE SI ESAURISCOMO LE 
RISORSE DEL DISPOSITIVO 

Nonostante Apple abbia cercato di fornire al singo- 
lo applicativo che viene eseguito volontariamente 
dall'utente (sono owiamente in esecuzione pro- 
cessi di supporto in maniera trasparente, come 
quelli di localizzazione, accelerometri e altri senso- 
ri, gestione della di telefonia etc) la massima quan- 
tita di memoria disponibile, e sempre possibile 
incorrere nella situazione in cui si occupi una tale 
quantita di memoria durante l'esecuzione del pro- 
prio software, sia a causa dell'utilizzo di grandi 
strutture dati, sia per errori di programmazione, che 
generano i cosiddetti leak (locazioni di memoria 
occupate, ma non rilasciabili dall'Autorelease Pool 
e neppure dall'utente, di cui parleremo nel prossi- 
mo articolo), raggiungendo un valore prossimo a 



1.5MB, scatenando un sistema di awisi e invocazio- 
ni di metodi automatici; per ogni istanza figlia diret- 
ta, o indiretta, di UlViewController venkinvocato: 

- (void)didReceiveMemoryWarning { 

NSLog(@"Memoria insufficiente ricevuto nel 
UlViewController! !!!"); 

y~ 

mentre per il file chiamato nome_applicativo App- 
Delegate.m, quello responsabile della visualizzazio- 
ne e della gestione del nostro applicativo : 

- (void) applicationDidReceiveMemoryWarning: 

(UIApplication*)application { 
NSLog(@"Memoria insufficiente! ! ! !"); 

y~ 

Verra inoltre inviata al nostro applicativo una notifica 
(argomento non trattato in questa serie di articoli) 
del tipo UIAppl ica ti o n D iclRece i veMe m o ry Wa rn i n - 
gNotification. In ognuno di questi metodi dovremo 
prowedere in maniera manuale alia rimozione di 
risorse non necessarie al momento, oppure ricreabili 
quando necessario, come strutture dati ottenute pre- 
levando le proprie informazioni da file disponibili 
localmente. Nelle due sezioni di codice utilizzate e sta- 
to aggiunto un metodo NSLog, di stampa a schermo 
(simile a printf 'del C) alio scopo di consentire in fa- 
se di debug di avere un feedback immediato di cosa 
sta succedendo; e comunque consigliato sempre te- 
stare il proprio applicativo sullo smartphone per ve- 
rificare se il warning di memoria insufficiente viene 
invocato in qualche situazione. Per forzare questa 
situazione nel simulatore, che ricordiamo ha acces- 
so alle nostre risorse hardware, parliamo quindi di 
almeno 1GB di RAM, contro i 128MB dell'iPhone 3G 
e i 256MB del 3GS, basta, durante una simulazione, 
cliccare sulla voce "hardware" presente nel menu 
del simulatore e selezionare la voce "simulate me- 
mory warning'. Non bisogna ignorare e neppure tra- 
lasciare una corretta implementazione di questi me- 
todi, perche possono essere la soluzione per realiz- 
zare progetti di medie- grandi dimensioni dove le ri- 
chieste di risorse possono superare quelle disponi- 
bili. 



CONCLUSION! 

In questo articolo, prettamente teorico, abbiamo 
acquisito ulteriori nozioni, che si riveleranno utili 
in qualsiasi contesto vi troverete in futuro; nel pros- 
simo articolo continueremo a spiegare come vie- 
ne gestita la memoria e parleremo di retain, re- 
tainCount, release e altri concetti altrettanto im- 
portanti . Buona programmazione. 

Andrea Leganza 
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Prosegue in questo articolo la trattazione 
della gestione della memoria. Introdotto 
nel precedente numero della rivista, 
l'argomento consentira una comprensione piu 
approfondita dei vari elementi che abbiamo 
incontrato nel primo articolo, e che applichere- 
mo, in tutti i futuri articoli dedicati al dispositivo 
mobile sviluppato dalla casa di Cupertino. 



RETAIN E RETAiniCOUNT 

Come accennato nel numero precedente, esisto- 
no due modi per evitare che le proprie variabili 
vengano rimosse automaticamente dall'Auto- 
release Pool, utilizzare retain o alloc. 
Nel primo caso basta invocare tale metodo 
durante la creazione della variabile, dove viene 
invocato come detto in maniera trasparente il 
metodo autorelease, oppure successivamente, 
all'interno del metodo in cui questa viene creata. 

NSMutableString *newText = [[NSMutableString 

initWithString: @"Lavoro da fare."] retain]; 
//inizializzata a retainCount = 1, invocato in maniera 
trasparente autorelease (-1 all'istante casuale t=x) e 
viene aggiunto 1 utilizzando retain: dopo il passaggio 
nell'Autorelease Pool avra quindi retainCount pari a 
l = l(allocazione)-l(autorelease) + l(retain) 

oppure: 

NSMutableString *newText = [NSMutableString 

initWithString: @"Lavoro da fare."]; 

[newText retain]; 

In questo modo si e creato un legame indissolu- 
ble tra la nostra istanza della classe e la variabile 
che stiamo utilizzando, abbiamo ora il pieno 
controllo sul suo tempo di vita, se non rilascere- 
mo in futuro tale variabile non sara mai deallo- 
cata. Associata a retain esiste la variabile interna 
a ogni oggetto che abbiamo detto chiamarsi 
retainCount; tale variabile e presente in tutti gli 



oggetti che discendono da NSObject (che come 
abbiamo detto in un precedente articolo sono la 
maggior parte); retainCount assume un valore 
numerico intero, e un contatore e indica il nume- 
ro di oggetti che hanno chiamato il metodo 
retain su un determinato oggetto, hanno quindi 
dichiarato che la stanno utilizzando, e ne sono 
quindi co-proprietari: non venite tentati dal 
desiderio di utilizzare sistemi di stampa a scher- 
mo (NSLog) per visualizzarlo, perche otterrete 
spesso valori non coerenti, oppure superiori a 
quello previsto: per effettuare un'analisi su tale 
variabile entra in gioco Instruments, di cui parle- 
remo in un altro articolo. RetainCount assume 
valore 1 quando la relativa variabile viene inizia- 
lizzata. Spieghiamo meglio questo che e uno dei 
concetti fondamentali del linguaggio Objective- 
C: e normale quando si sviluppa un qualunque 
applicativo, passare variabili da una classe a una 
altra invocando i rispettivi metodi, durante que- 
sta operazione vengono utilizzati come parame- 
tri le istanze delle classi che abbiamo creato in 
precedenza, poiche pero, andando a scavare in 
profondita parliamo sempre degli amati/odiati 
puntatori del C, e stato introdotto il concetto di 
retain per evitare che tali variabili vengano deal- 
locate automaticamente se una o piu classi 
hanno dichiarato che la stanno utilizzando; in 
questo modo si riduce il rischio che awengano 
crash in cascata dovuti alia deallocazione auto- 
matica effettuata dall'Autorelease Pool (mentre 
se deallocate manualmente tali variabili tali pro- 
blemi si possono sempre presentare , e prendono 
il nome di Zombie) che, senza tale artificio, non 
avrebbe modo di valutare se una variabile e inu- 
tilizzata oppure no. Ipotizziamo che una classe A 
invochi un metodo passaggioStringa su una clas- 
se B, passando un parametro di tipo NSString, 
una semplice stringa di testo (per la precisione 
un oggetto testo, differente sintatticamente dalle 
stringhe C che sono array di caratteri) quindi, se 
questa seconda classe desiderasse utilizzare in 
un altro momento, al di fuori del metodo in que- 
stione, tale variabile senza dover effettuare una 
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copia profonda (deep copy) del suo contenuto in 
una variabile locale, potrebbe facilmente effet- 
tuare la seguente operazione: 

//Classe A; 

-(void)testRetainCount { 
//inivializzazione stringa (e autorelese) 
NSMutableString *stringaA = [NSMutableString 

initWithString[@"Telefonare assistenza"]]; 
//retainCount =1, essendo autorelase scendera 
a retainCount=0 in un prossimo futuro, dopo I'uscita 
dal metodo corrente e verra deallocata; 
//chiamata del metodo di B passando la stringa 
[istanzaB passaggioStringa:stringaA]; 
//stringaA verra deallocata in futuro se non 

avra retainCount>0 



//Classe B 

NSMutableString *myString; 

-(void)passaggioStringa: (NSMutableString *)stringa{ 
myString = stringa; //myString punta alia 

stessa posizione in memoria di stringa 
[stringa retain]; //identico risultato se si 

effettua[ myString retain] 
//stringa ora ha retainCount=2 non verra deallocata 

perche verra decrementata a 1 dall'autorelease pool. 

T~ 

Poiche stringaA e stata creata immediatamente 
prima dell'invocazione del metodo, avra 
retainCount pari a 1, che diventera 0 in futuro 
poiche e autorelease, viene inoltre inserita nel- 
l'autorelease pool e per tale motivo verrebbe rila- 
sciata al termine del metodo testRetainCount, 
ma cio non awiene poiche all'interno di 
passaggioStringa tale valore viene incrementato 
a 2, utilizzando retain; la prima riga effettua una 
semplice copia tra puntatori, non viene quindi 
creata alcuna nuova variabile, ma myString 
punta alia stessa locazione di memoria di strin- 
ga, e non viene incrementato il retainCount di 
stringa, mentre la seconda riga incrementa di 1 il 
retainCount della variabile stringa, portandolo al 
valore 2; in questo modo si evita che questa 
venga deallocata automaticamente dall'Autore- 
lease Pool al termine del metodo testretainCount, 
infatti fuori da tale metodo avra valore 1 (dopo 
che autorelease avra svolto il suo compito). 
Effettuare il retain su stringa, oppure su myString 
e ininfluente poiche puntano alio stesso oggetto 
in memoria. Se non utilizzassimo retain all'inter- 
no di passaggioStringa: 

//Classe A; 

-(void)testRetainCount { 

NSMutableString *stringaA = [NSMutableString 

initWithString[@"Telefonare assistenza"]]; 



//chiamata del metodo di B passando la stringa 
[istanzaB passaggioStringa: stringaA]; 

} 

//Classe B 

NSString *myString; 

-(void)passaggioStringa:( NSMutableString *)st 
myString = stringa; 

} 

-(void)letturaMyString {NSLog (@"%@",myString)} 

All'uscita del metodo passaggioStringaXz, variabile 
stringaA verrebbe deallocata dopo I'uscita dal 
metodo testReatinCount e ogni accesso successi- 
ve in A, e in altri metodi di B, a myString 
(myString e stringaA sono sinonimi come spiega- 
to) genererebbe un crash del sistema. 
La lezione da tenere bene a mente e quindi quel- 
la di cercare di avere una chiara visione del 
tempo di vita delle variabili per evitare ore di 
debugging. 




RELEASE DI UN OGGETTO 

Quando decidiamo di notificare all' autorelease 
pool che non vogliamo piu utilizzare una variabi- 
le, non vogliamo quindi esserne proprietari 
(come e stato detto e piu opportuno dire copro- 
prietari con altre istanze), invochiamo su di essa 
il metodo release, che decrementa di un'unita il 
suo retainCount: utilizziamo il comando [nome- 
variabile release], in questo modo, se la nostra 
variabile aveva retain count pari a 1 scendera a 0 
e verra rilasciata immediatamente: attenzione, 
quindi, se viene deallocata non potrete piu acce- 
dervi, e, nel caso lo faceste, causerete un crash 
del sistema (questa operazione errata di accesso 
viene identificata con 1' accesso a uno Zombie, e 
ne parleremo verso la fine di questo articolo). 
Le regola per evitare di incorrere in decine di pro- 
blemi di gestione della memoria e quella di 
bilanciare il numero di retain con quello di relea- 
se, in tal modo, quando si effettuera l'ultimo 
release, si fara sempre scendere il retainCount a 0 
e l'Autorelease pool invochera il metodo deallocQ 
sulla variabile (il metodo che svolge la funzione 
di distruttore, quindi responsabile della rimozio- 
ne delle risorse utilizzat: variabili, strutture dati e 
canali di comuncazione in primis); owiamente, 
se si desidera mantenere in vita un'istanza per 
tutto il tempo di vita della propria applicazione 
tale numero dovra essere sempre maggiore di 0. 
Un esempio pratico della variazione della 
variabile retainCount e quello di pensare al 
numero di scalini necessari per raggiungere un 
piano, il numero di passi da effettuare per sali- 
re sulla sommita prima e poi riscendere e sem- 
pre uguale. 
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ULTERIORI 
APPROFONDIMENTI 

Per approfondire i concetti 
mostrati in questo articolo, 
consultare la guida 
chiamata Memory 
Management Programming 
Guide for Cocoa disponibile 
su sito 

developer.apple.com o 
all'interno della 
documentazione fornita con 
Xcode 



Invece di release, che effettua il decremento 
immediatamente, si puo anche invocare 
manualmente autorelease, che prowedera a 
decrementare retainCount in futuro: questo 
approccio non e consigliabile ed e meglio rila- 
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Fig. 1: Un tipico ciclo di vita di una variabile, quando 
il retaincount raggiunge il valore 0 viene automatica- 
mente rilasciata; si noti inoltre il bilanciamento 
dei retain con quello dei release, che permettono 
di farlo scendere a 0 



sciare subito una variabile, sia per liberare il 
prima possibile una risorsa (e questa e una rego- 
la che si dovrebbe applicare in ogni linguaggio di 
programmazione, ma nel contesto mobile e di 
fondamentale importanza dove le risorse sono 
piu limitate), ma anche per non incorrere nei 
problemi di accesso precedentemente spiegati, 
in primis a variabili deallocate automaticamente 
in un momento non precisato. 
E possibile invocare numerose volte release? In 
sequenza certamente, ma non e consigliabile se 
lo si effettua per risolvere problemi di gestione 
non corretta della memoria, ad esempio quando 
si dealloca un oggetto e non si effettua il release 
nel suo distruttore sulle variabili che questa uti- 
lizzava e si bypassa il problema in questo modo: 
generalmente rispecchia una cattiva compren- 
sione del concetto di retain /release, puo comun- 
que risultare necessario in particolari situazioni. 
Molti metodi effettuano un retain automatico, ad 
esempio quando aggiungiamo una variabile a un 
array, e dal punto di vista pratico risulta 
un'operazione automatica molto utile, poiche gli 
oggetti inseriti vengono segnalati automatica- 
mente di proprieta di un determinato oggetto e 
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Fig. 2: Durante il tempo di vita di una variabile 
il retainCount sale e scende, fino generalmente 
a terminare in un determinato istante t 



non verranno rilasciati se non quando 1' array 
verra rilasciato; questa operazione automatica 
puo risultare pero causa di problemi quali leaks e 
zombie (spiegati in questo stesso articolo). Se si 
vuole deallocare immediatamente una variabile, 
disinteressandosi del retainCount, bastera invo- 
care il metodo deailocQ su di essa, questa opera- 
zione e pero sconsigliata, poiche, ignorando il 
retainCount, si ignora quante altre istanze la 
stanno al momento utilizzando e si potrebbero 
avere numerosi crash del sistema {Zombie). 
Nella documentazione dell'API viene dichiarato 
se un certo metodo di una classe effettua oppure 
no il retain / release sull' oggetto passato come 
parametro, e comunque possibile utilizzare 
Instruments per verificare tale comportamento. 



COSA SONO I LEAK 

Non effettuare correttamente la gestione delle 
risorse in memoria porta ai cosiddetti leaks. 
Con tale termine si identifica quella variabile che 
non e piu accessible all'interno di alcun metodo 
di una classe e non vi e quindi alcun modo per 
invocare su di essa il release/ autorelease/ dealloc. 
la variabile e quindi irraggiungibile dal codice 
realizzato dall'utente e, essendo gestita dall'u- 
tente, non puo essere rimossa automaticamente 
dall'Autorelease Pool; in questo modo avremo un 
dispendio di memoria, in genere incrementale, 
che potrebbe portare, quando si parla di un 
numero di variabili medio grande (a seconda 
della loro singola occupazione di memoria), alia 
chiusura forzata del nostro programma. Un leak 
e quasi sempre, quando non e un bug di cui sono 
responsabili i tecnici di casa Apple (awiene ad 
esempio quando si utilizza il parser NSXML), 
segnale di una programmazione errata, disatten- 
ta o poco consapevole. Per monitorare tali situa- 
zioni si utilizza il tool chiamato Instruments, che 
fornisce in real-time dettagli sul numero e su 
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quale sequenza di chiamate/comandi hanno 
generato tale leak. Un esempio di leak e stato 
descritto nel paragrafo precedente, quando 
abbiamo parlato del mancato rilascio delle varia- 
bili inserite in un array; in tal caso, se non avre- 
mo piu accesso diretto all' array, non riusciremo 
piu a liberare gli oggetti inseriti al suo interno, 
che diverranno quindi leak. 



IL METODO ALLOC 

II secondo metodo per evitare che una variabile 
venga deallocata automaticamente, e quello di 
crearla utilizzando il metodo alloc, che imposta il 
suo retainCount a 1 (effettua quindi un retain 
automatico), e sara quindi nostra cura decre- 
mentarlo utilizzando release/autorelease per 
consentire, poi, nel caso tale valore raggiunga 
valore 0, all'Autorelease Pool di invocare su di 
esso il metodo dealloc. Quando si usa alloc, si 
richiede che venga allocato lo spazio in memoria 
necessario per contenere tale istanza. Per inizia- 
lizzare il suo contenuto si invoca generalmente 
un metodo che inizia con il prefisso init, che 
completa, quindi, la fase di impostazione del suo 
stato interno. La mancata invocazione di un 
metodo init su un'istanza, la rende inutilizzabile 
nella pratica; poiche nel linguaggio Objective -C 
non esiste una regola per identificare un costrut- 
tore, e non e neppure obbligatorio crearlo, anche 
se risulterebbe di scarsa utilita non realizzarne 
almeno uno, si ha la possibility di creare un 
numero indefinito di costruttori che soddisfino 
le proprie necessita. Generalmente, comunque, 
viene utilizzato il prefisso init per ognuno di que- 
sti, quindi bastera digitare init quando compa- 
rira la lista di autocomplete per verificare quali 
sono stati resi disponibili. II costruttore piu sem- 
plice e caratterizzato dalla seguente signature - 
(id) init(): di questo ne parleremo approfondita- 
mente in un prossimo articolo. 

NSMutableString *stringa; 

stringa = [[NSMutableString alloc] initWithString: 

@"testo"]; //retainCount=l 

In questo caso abbiamo creato un'istanza di un 
oggetto appartenente alia classe NSMutable- 
String, in grado di contenere una stringa di 
dimensione variabile, prima definendola, poi 
allocandola e infine inizializzando il suo valore 
interno con una stringa; il retainCount e pari a 1 
e potremo utilizzarla in qualunque metodo noi 
desideriamo, poiche il contatore non verra mai 
decrementato automaticamente. Quando sara 
necessario, potremo invocare su di essa il meto- 
do release e farla deallocare, e quindi sempre vali- 



da la regola del rapporto uno a uno tra retain e 
release. Attenzione, se la variabile viene dichia- 
rata e definita in un metodo, e quindi locale alio 
stesso, cosi come nel caso che segue: 

- (void) initMyString { 

NSMutableString *stringa; 
stringa= [[ NSMutableString alloc] 

initWithString : @"testo"] ; 

[stringa release]; 

y~ 

se non si prowede a rilasciarla al suo interno, 
prima della fine del metodo, avremo un leak, poi- 
che fuori da questo non sara piu possibile acce- 
dervi e rilasciarne la memoria. 
Un utilizzo che non presenta tale inconveniente 
e quello in cui la variabile appartiene a una istan- 
za della classe, ed e accessible in qualunque suo 
metodo interno: 

NSMutableString *stringa; 

- (void)initMyString { 

stringa = [[ NSMutableString alloc] initWithString :@"testo"]; 
} 

-(void) removeString {[stringa release]; 

y~ 

Poiche abbiamo accennato deH'inserimento di 
oggetti in un array, viste le conoscenze ora acqui- 
site, si puo affrontare il problema in due modi: 
utilizzando come struttura dati un NSMutable 
Array, oweroun array la cui dimensione puo 
cambiare dinamicamente, semplicemente 
aggiungendo/rimuovendo oggetti e, quindi, 
invocando alcuni metodi. Leggiamo prima un 
estratto della documentazione associata a tale 
classe: 

If you do not use garbage collection, when you add an 
object to an array, the object receives a retain message. 
When an object is removed from a mutable array, it 
receives a release message. If there are no further ref- 
erences to the object, this means that the object is 
deallocated. 

Poiche, come e stato gia detto in precedenza, 
non siamo in in ambiente con un vero Garbage 
Collector, ogni oggetto che verra inserito nelT ar- 
ray ricevera un retain, mentre ricevera un release 
quando verra rimosso, oppure quando si invo- 
chera release smT array stesso. Simuliamo 
Finserimento: 

NSMutableArray *array = [[NSMutableArray alloc] init]; 
for (int i = 0; i < 10; i++) { 

NSMutableString *convenienceString = 

[NSMutableString stringWithString:@"testo"]; 
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//retainCount 1 e autorelease 




SNOW LEOPARD 
EXCODE 3.2 

I possessori di Snow 
Leopard hanno modo di 
utilizzare il software di 
analisi statica chiamato 
Clang, integrate con XCode 
3.2. Purtroppo non e 
installable su Leopard 
10.5. Questo tool fornisce 
informazioni dettagliate su 
tutti i punti in cui possono 
verificarsi Zombie e Leaks: 
bastera invocare il 
comando 'Build and 
Analyze' presente nel 
menu Build. 



[array addObject:convenienceString]; 
//retain automatico del metodo sul parametro 

retainCount 2 di convenienceString 



...autorelease automatico al tempo x: su tutte le 

variabili inserite nell'array assumono retainCount= 
1... 

[array release] //array invia release alle proprie 

variabili quindi il loro retainCount scende a 0 e 

vengono deallocate, array viene ovviamente rilasciato 
dopo questa operazione e deallocato se il suo 
retainCount=0 (non effettua un controllo se il 
retainCount degli oggetti al suo interno e >0) 

Non abbiamo utilizzato alloc, quindi tutte le 
istanze di convenienceString vengono rilasciate 
automaticamente quando rilasceremo 1' array 
(perche sono autoreleased). convenienceString 
assumera retainCount pari a 2 poiche addObject, 
da come e dichiarato esplicitamente dalla docu- 
mentazione dell'API, effettua un retain sul para- 
metro passato al metodo addObject, essendo di 
tipo autorelease ognuna delle dieci istanze inse- 
rite nel ciclo for verra decrementata a 1 automa- 
ticamente, il successivo rilascio dell' array effet- 
tuera un'ulteriore release su ognuno di questi, e 
il loro retainCount verra portato a 0, sara percio 
invocato il dealloc su ogni variabile di tipo 
NSMutableString che abbiamo inserito. 

NSMutableArray *array = [[NSMutableArray alloc] init]; 
for (int i = 0; i < 10; i++) { 
NSMutableString *convenienceString = 

[NSMutableString stringWithString:@"testo"]; 
[array addObject: convenienceString]; 

//retaincount di convenienceString = 2 
[convenienceString release]; // retaincount di 

convenienceString = 1 
[array release]; //array invia release agli oggetti 

che contiene, quindi convenienceString assumera 
retainCount=0 e verra dellocato; non si avranno quindi leaks 

y~ 

In questo caso abbiamo utilizzato alloc, quindi 
e necessario rilasciare la variabile per evitare 
leaks, poiche altrimenti tutte le istanze di 
allocedNumber presenti nell'array avranno 
retainCount^^ a 2 e, quando proveremo a rila- 
sciare 1' array, il loro retainCount scendera a 1 
impedendone il rilascio e generando un leak 
dieci in questo preciso esempio, (poiche deallo- 
chiamo 1' array non potremo piu accedervi e, 
conseguentemente, non avremo modo di acce- 
dere a queste variabili con retainCount pari a 1). 
Questo secondo approccio ha il pregio di libera- 



re immediatamente le risorse, e risulta quindi 
molto adatto in situazioni in cui si genera un 
numero consistente di inserimenti. 
Confrontiamo le due soluzioni: nel primo caso 
avremo un numero di oggetti incrementale, si 
passera da 1+1 della prima iterazione a n+n 
quando si arrivera all'ultima, tale numero 
diventera poi pari a n solo dopo il termine del 
metodo, quando le istanze allocate riceveranno 
1' autorelease; nel secondo caso a ogni iterazione 
avremo in memoria un numero di oggetti pari a 
quelli inseriti nell'array e a quello che verra rila- 
sciato alia fine dell'iterazione, quindi da 1+1 a 
n+1 (n istanze inserite nell'array e l'oggetto allo- 
cato di tipo NSNumber). Esiste una terza alter- 
nativa, che consiste nell' utilizzare un Pool loca- 
le a tale metodo che conterrebbe le variabili 
create nel primo esempio e le rilascerebbe al 
termine del ciclo, ma non complichiamo ulte- 
riormente. Bisogna comunque tenere quindi a 
mente certe considerazioni quando si lavora su 
strutture dati popolate con oggetti di dimensio- 
ni non ridotte. 



ZOMBIE 



EXC_BAD_ACCESS rappresenta uno di quegli 
errori che riceverete piu frequentemente quando 
inizierete a creare istanze di classi in Objective-C, 
questo errore viene generato quando il vostro 
codice tentera di accedere ai cosiddetti Zombie, 
sinonimo di istanze di classi non piu disponibili, 
perche deallocate in precedenza. Prendiamo in 
considerazione come esempio il seguente codice: 

NSMutableString *stringa; 
-(void) scatenaZombie { 
[self initMyString]; [self printMyString]; 



(void) initMyString { 



stringa = [[ NSMutableString alloc] 

initWithString : @"testo"] ; 
[stringa release]; //la variabile viene deallocata 



} 



-(void) printMyString { 



NSLog ("%@", stringa); //accesso ad uno zombie 



} 



Inizializzando nel metodo initMyString la nostra 
stringa, e successivamente deallocandola richia- 
mando il metodo release, abbiamo posto fine al 
suo tempo di vita; se pero invocheremo successi- 
vamente a tale metodo quello chiamato 
printMyString riceveremo un errore da parte del 
debugger in esecuzione, poiche tale metodo 
prova ad accedere a un'istanza non piu disponi- 
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bile. Questo errore si presenta anche nel caso in 
cui si sbilanci il numero di retain e release, invo- 
cando quindi un numero di questi ultimi mag- 
giore del retainCount disponibile: 

-(void) scatenaZombie { 
[self initMyString]; 
[self removeMyString]; 



} 



(void) initMyString { 



stringa = [[ NSMutableString alloc] 

initWithString : @"testo"] ; 
[stringa release]; //la variabile viene deallocata 



} 



-(void) removeMyString { 



[stringa release]; //secondo release : accesso ad 

uno zombie 



} 



Purtroppo questo tipo di errore non viene corre- 
dato da informazioni sufficienti per comprende- 
re in quale porzione di codice awiene il proble- 
ma, e per risolvere tale mancanza del debugger e 
necessario impostare un particolare parametro 
di configurazione aH'interno delle opzioni del file 
eseguibile generato da XCode. Fate doppio clic 
sulla voce (ha il nome del vostro progetto) pre- 
sente come riga aH'interno nella colonna di sini- 
stra di XCode, Goups & Files, sotto la categoria 
Executables e selezionate Arguments dal menu in 
alto; inserite una riga all'interno del box 
Variables to be set in the Enviroment con il seguen- 
te valore: NSZombieEnabled e impostando come 
valore YES. Dopo aver effettuato questa opera- 
zione, invece di un laconico EXC_BAD_ACCESS, 
otterremo una stringa leggermente piti interes- 
sante. 

*** -[CFString retain]: message sent to deallocated 

instance 0xd21b50 

Questa riga di errore ci fornisce Findirizzo in 
memoria dell'oggetto che ha causato il crash del 
software, ma non e ancora sufficientemente 
comodo per identificare velocemente quale 
istanza genera il problema. Questa impostazione 
deve essere utilizzata solamente in fase di svilup- 
po e non in fase di rilascio poiche non rilascia 
alcuna variabile alio scopo di consentire lo stu- 
dio delle variabili Zombie! Una soluzione per evi- 
tare di dimenticarsi tale impostazione attiva, 
consiste nell'inserire il seguente codice nel file 
NomeApplicazioneDelegate.m come prima riga 
del metodo applicationDidFinishLaunching: 

- (void)applicationDidFinishLaunching:(UIApplication 

*)application { 

if(getenv("NSZombieEnabled")) { 



NSLog(@"NSZombieEnabled!!! Disable when 
compiling for release");}... 

Ricordatevi sempre di disabilitarla quando com- 
pilerete il vostro software per l'Apple Store. 
Per avere ulteriori informazioni su tale errore 
bisogna impostare un breakpoint che permettera 
di awiare il debugger con un dettagliato, e piti 
utile, stack delle chiamate. Selezionando la voce 
del menu Run->Show->BreakPoints si presentera 
una finestra dove e possibile inserire e visualizza- 
re i breakpoint impostati. Aggiungiamone uno 
inserendo il seguente testo: 

-[_NSZombie methodSignatureForSelector:] 

Impostando un breakpoint su tale metodo, si 
fara in modo che il debugger interrompa 
l'esecuzione dell' applicative prima che questo 
crashi, fornendo informazioni sullo stack trace e 
mostrando quale variabile ha generato il crash. 
Quando si verifichera un accesso a uno Zombie 
potrete quindi ottenere informazioni dettagliate, 
ma soprattutto il nome della variabile e identifi- 
care il metodo in cui e awenuto 1' errore. Questo 
sistema non funziona purtroppo con tutte le 
classi fornite dall'SDK, e in tal caso diventa tutto 
piu complicato. Per ridurre al minimo questo 
problema di accesso, basta impostare a nil il 
valore della variabile, immediatamente dopo il 
suo rilascio (dopo il release o autorelease), in tal 
modo qualunque invocazione non avra alcun 
risultato, ma almeno non fara crashare il softwa- 



CONCLUSIONI 

Tutto quello che abbiamo spiegato in questi due 
articoli si applica a quasi tutte le classi discen- 
denti da NSObject (NSString ad esempio si com- 
porta in modo diverso, e spiegheremo il perche 
nel prossimo articolo), purtroppo perde di vali- 
dity quando utilizziamo strutture dati e tipi di 
dati presi direttamente dal linguaggio C, ad 
esempio creando variabili di tipo int o float, che 
in mano a un programmatore accorto possono 
fare la differenza in termini di prestazioni per un 
software. In questo articolo, prettamente teorico, 
abbiamo acquisito ulteriori nozioni, che si rivele- 
ranno utili in qualsiasi contesto vi troverete in 
futuro; nel prossimo numero della rivista torne- 
remo a trattare della popolazione della tabella e 
modificheremo il codice creato in automatico 
per realizzarla; mostreremo anche come popola- 
re le relative celle. Buona programmazione. 

Andrea Leganza 



ZOMBIE E LEAKS 

Si accede a uno zombie 
quando si invocano metodi 
o si richiedono variabili di 
un'istanza non piu 
disponibile, perche 
deallocata (autorelease 
automatico oppure release 
manuale); un leak, invece, 
identifica un'istanza non 
piu accessible da parte del 
codice, poiche non e stata 
deallocata quando era 
invece necessario. 
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COME POPOLARE 
UNA UITABLEVIEW 

IN QUESTO ARTICOLO POPOLIAMO LA NOSTRA TABELLA CON UN ELENCO Dl VOCI 
OTTENUTE INTERROGANDO UNA SERIE Dl STRUTTURE DATI. NELLA FATTISPECIE VEDREMO 
COME INSERIRE DELLE SEMPLICI RIGHE, CREARE DELLE SEZIONI E NAVIGARE TRA LE STESSE 





Conoscenze richieste 



Li 00P 



MacOSX 10.5.4 o 
superiore, XCode 



Impegno 



0000' 



Nei numeri precedenti di questa seconda 
serie di articoli dedicati alia programma- 
zione dell'iPhone abbiamo momenta- 
neamente abbandonato il nostro progetto, una 
T0D0 List, per trattare alcuni argomenti di fonda- 
mentale importanza relativi al linguaggio Objec- 
tive-C e alia gestione della memoria in un 
ambiente non governato da un moderno stru- 
mento automatico qual e il Garbage Collector. 
Riprendiamo ora a trattare della popolazione 
della UITableView che avevamo creato utilizzan- 
do il wizard di XCode e selezionando il progetto 
di tipo Navigation-based Application. 



METODI PER POPOLARE 
UNA TABELLA 

Per semplicita riproponiamo il corpo del metodo 
tabelView;cellForRowAtIndexPath che viene genera- 
te automaticamente dal wizard: 

// Customize the appearance of table view cells. 
- (UITableViewCell *)tableView:(UITableView 

*)tableView cellForRowAtIndexPath:(NSIndexPath 
*)indexPath {static NSString *CellIdentifier = @"Cell"; 
UITableViewCell *cell = [tableView 
dequeueReusableCellWithIdentifier:CellIdentifier]; 

if (cell == nil) { 

cell = [[[UITableViewCell alloc] 

initWithStyle:UITableViewCellStyleDefault 
reuseldentifienCellldentifier] autorelease]; 

} 

// Configure the cell, 
return cell; 

y~ 

Poiche abbiamo sufficientemente trattato in prece- 
denza di alloc, autorelease e nil, iniziamo immedia- 
tamente a popolare la nostra tabella nel modo piu 
semplice: inserendo "manualmente" una stringa di 
testo aU'interno di tutte le righe della nostra lista di 
cose da fare. Prima di cio, e doveroso descrivere 



molto brevemente la struttura tipica di una cella, 
almeno riguardo le versioni fornite nell'SDK. 
Una cella svolge la funzione di unita atomica di ogni 
tabella, ma in pratica e un contenitore anch'essa di 
numerosi componenti: trovano posto, almeno nelle 
versioni predefinite, due istanze di UILabel, una 
disponibile con l'identificatore di textLabel, l'altra 
come detailTextLabel, una UWiew con il nome 
accessoryType, un UllmageView con il nome di 
imageView, e terminiamo con una UWiew chiamata 
backgroundView; in realta la lista di componenti 
disponibili non e terminata, ma generalmente que- 
sti sono quelli utilizzati nella maggior parte di appli- 
cazioni, a meno di realizzare customizzazioni relati- 
vamente complesse; le due UILabel svolgono il 
compito di mostrare il testo associato alia riga, 
1' accessoryType consente di impostare il tipo di icona 
da posizionare sulla destra della cella per indicare la 
possibile presenza di un ulteriore livello di dettaglio, 
la imageView, quando viene associata a 
un'immagine, la mostrera sul lato sinistro della 
cella, prima del testo, la backgroundView consente 
di variare in maniera relativamente avanzata 
l'aspetto della cella. 

Nel caso in cui variare le impostazioni di questi 
componenti non ottenesse i risultati sperati, si 
potranno aggiungere uno 0 piu oggetti accedendo 
alia proprieta chiamata contentView, anch'essa un 
UWiew, che svolgera per questi nuovi oggetti la fun- 
zione di superview: in caso di necessita sara quindi 
questo componente che dovrete utilizzare per inse- 
rire altre UILabel, immagini 0 altro; se invece si 
richiedesse una completa ristrutturazione della sin- 
gola cella, sara necessario ignorare l'inizializzazione 
utilizzando gli stili predefiniti (quindi il metodo 
initWithStyleireuseldentifier utilizzato dal wizard) e 
invocare la versione minimale deirinizializzazione 
{inif) e inserire e configurare manualmente ogni 
componente (impostando posizioni, dimensioni e 
parametri). Per effettuare una customizzazione e 
anche possibile utilizzare Interface Builder, ma non 
tratteremo di questo aspetto nel presente articolo. 
Per rendersi conto delle potenzialita delle customiz- 
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zazioni possibili per le celle basta semplicemente 
aprire i settings /impostazioni disponibili su iPhone. 
Quasi ogni schermata presenta una diversa versione 
di cella. Generalmente si impostano le caratteristi- 
che estetiche comuni a tutte le celle, e che per tale 
motivo resteranno immutate per tutta la vita della 
tabella, alFinterno del blocco di testo in cui queste 
celle vengono allocate e inizializzate (quindi alFin- 
terno del blocco relativo a if(cell--nil))\ immediata- 
mente dopo di questo si inserira il codice necessario 
a customizzare la riga, in base al contenuto relativo 
alia singola variabile associata. 
Modifichiamo il tipo di cella passando dal tipo pre- 
definito UITableViewCellStyleDefault a quello UI 
TableViewCellStyleValuel per consentirci di inserire 
un testo nella parte destra della cella. 

// Customize the appearance of table view cells. 



if (cell == nil) { 

cell = [[[UITableViewCell alloc] 

initWithStyle:UITableViewCellStyleValuel 
reuseldentifienCellldentifier] autorelease]; 



_} 

// Configure the cell. 

//Oltre questo commento inseriremo il codice per 

modificare i testi delle celle 

Ora possiamo impostare il testo che verra visualiz- 
zato per tutte le righe; per fare cio dovremo accede- 
re a uno dei componenti visuali contenuti nella 
cella, identificato dal nome textLabel, tale compo- 
nents come e stato detto, non e altro che una 
UILabel che consente di mostrare a schermo una 
stringa di testo semplicemente impostando il valo- 
re della sua proprieta text. 



cell = [[[UITableViewCell alloc] 

initWithStyle:UITableViewCellStyleValuel 
reuseldentifienCellldentifier] autorelease]; 
// Configure the cell, 
cell. textLabel. text= @"Riga di testo"; 
return cell 
T~ 

Awiamo il simulatore, notiamo pero che non verra vi- 
sualizzato alcun testo: questo e dovuto al fatto che, 
come abbiamo spiegato in precedenza, ogni tabella 
richiede al proprio delegate (in questo caso la nostra 
classe RootViewController generata dal wizard), at- 
traverso l'invocazione su di questo di due metodi num- 
berOfSectionsInTableView: e tableView: numberO- 
fRowsInSection, il numero di sezioni e quello di righe 
per ogni sezione disponibile: 

- (NSInteger)numberOfSectionsInTableView: 



(UITableView *)tableView { return 1;} 
// Customize the number of rows in the table view. 
- (NSInteger)tableView:(UITableView *)tableView 

numberOfRowsInSection:(NSInteger)section { 
return 0; } 



Come si pub notare, per default il wizard restituisce 
per ogni sezione presente, una in questo caso, il 
valore zero (0): cio impedisce la creazione di una o 
piu celle: modifichiamo con un valore maggiore di 
zero, ad esempio 15: 

// Customize the number of rows in the table view. 
- (NSInteger)tableView:(UITableView *)tableView 

numberOfRowsInSection : (NSInteger)section 
{ return 15; } 

Salviamo e awiamo il simulatore: finalmente otte- 
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Fig. 1: La tabella mostra un numero di righe a seconda 
del valore ottenuto invocando tableView: 
numberOfRowsInSection: 



RIFERIMENTI WEB 

Creazione dell'account 
per scaricare I'SDK 
e consultare la 
documentazione: 
http://developer. 
apple.com/iphone 



niamo un elenco, di scarsa utilita pratica, ma di 
indubbio valore didattico. Proviamo ora ad aggiun- 
gere un testo nella parte destra. Questa operazione 
la si compie, cosi come abbiamo fatto per il 
celltextLabel, accedendo a celldetailTextLabel, che 
e sempre un'istanza della classe UILabel: 



cell = [[[UITableViewCell alloc] 

initWithStyle:UITableViewCellStyleValuel 
reuseldentifienCellldentifier] autorelease]; 
cell. textLabel. text= @"Riga di testo"; 
cell. detailTextLabel. text = @"Testo"; 

Se avessimo utilizzato come style in fase di inizializzazione 
della cella quello di default [initWithStyleiUITable 
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GLI STILI 
PREDEFINITI 

Gli stili predefiniti per le celle, 
introdotti nell'SDK3.0, sono: 
UlTableViewCellStyleDefault, 
UlTableViewCellStyleValuel, 
UITableViewCellStyleValue2, 
UlTableViewCellStyleSubtitle; 



ViewCellStyleDefault), avremo ottenuto come risul- 
tato la visualizzazione di tale stringa di testo imme- 
diatamente sotto textLabel, con questo stile, invece, 
tale UILabel e presentata nella modalita che riteniamo 
piu comoda per una rapida consultazione di una to- 
do list. Impostiamo infine il simbolo grafico di detta- 
glio, disclosure button (Fig. 2), identificato con il sim- 
bolo di maggiore, per fare cio dovremo impostare ta- 
le proprieta delle celle airinterno del metodo in cui 
creiamo le istanze delle celle, parliamo quindi sem- 
pre di tabelView;cellForRowAtIndexPath: 

/if (cell == nil) { 

cell = [[[UITableViewCell alloc] 

initWithStyle: UlTableViewCellStyleValuel 
reuseldentifienCellldentifier] autorelease]; 
cell. accessory Type = 

UITableViewCellAccessoryDisclosurelndicator; 

T~ 

Completiamo questa prima versione impostando il 
titolo che viene mostrato nella Navigation Bar, la 
barra di colore blue posizionata nella parte piu alta 
della nostra applicazione, per fare cio decommen- 
tiamo il metodo viewDidLoad e aggiungiamo la 
seguente riga: 

- (void)viewDidLoad { 
[super viewDidLoad]; 

self.title = @"ToDo List"; 
// Uncomment the following line to display an Edit 
button in the navigation bar for this view controller. 
// self.navigationltem.rightBarButtonltem = 

self.editButtonltem ; 
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Fig. 2: Abbiamo ora ottenuto una struttura base 
per una tabella 



Perche abbiamo inserito questo semplice comando 
airinterno del metodo viewDidLoad 7 . Questo e uno 
dei primi metodi che vengono invocati esplicita- 
mente (ancora prima viene invocato il metodo 
initWithNibName) quando viene analizzato il file 
xib e 1' engine del telefono si prepara per mostrarlo 
visivamente: dopo viewDidLoad ogni istanza, diret- 
tamente o indirettamente legata a UlViewController, 
invochera in sequenza viewWillAppear e viewDid 
Appear (anche questi inseriti automaticamente dal 
wizard e anche questi da decommentare in caso di 
necessita); la scelta e caduta su viewDidLoad perche 
e uno dei metodi consigliati dalla stessa documenta- 
zione per effettuare al suo interno operazioni neces- 
sarie per la configurazione sia visuale che struttura- 
le del viewcontroller. Cambiamo ora il tipo di tabel- 
la da plain, quindi visualizzata come un continuo 
elenco in cui il nome delle sezioni viene presentato 
come un testo su uno sfondo blu scuro, a grouped, 
alio scopo di distanziare meglio i diversi giorni della 
settimana (senza doverci preoccupare di impostare 
parametri per gli header e i footer), per fare cio 
apriamo il file rootviewcontroller.xib con Interface 
Builder e, dopo aver selezionato la tabella, utilizzan- 
do il Property Inspector, selezioniamo grouped dalla 




Fig. 3: Impostiamo a grouped il tipo di visualizzazione 
della tabella 



voce a tendina. A questo punto testiamo il compor- 
tamento della tabella aumentandone il numero di 
sezioni, impostiamo a 7, i giorni della settimana che 
mostreremo nella schermata: 

- (NSInteger)numberOfSectionsInTableView: 

(UITableView *)tableView { return 7;} 

Mostriamo ora il titolo per ognuna delle sette sezio- 
ni, il giorno della settimana nel nostro caso; per fare 
cio utilizzeremo il metodo richiesto dalla tabella alia 
nostra classe/ delegate, la cui signature e tableView 
ititleForHeaderlnSectionv, tale metodo riceve come 
parametro un valore numerico a indicare la sezione 
che la tabella sta analizzando, un numero nell'inter- 
vallo compreso tra da 0 e numerosezioni-1 (7-1 = 6 
in questo caso); 

- (NSString *)tableView: (UITableView *)tableView 

titleForHeaderlnSection : (NSInteger)section 

{ 

switch (section) { 
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case 0: return @"Sunday"; break; 
case 1: return @"Monday"; break; 
case 2: return @"Tuesday"; break; 
case 3: return ©"Wednesday"; break; 
case 4: return ©"Thursday"; break; 
case 5: return @" Friday"; break; 
case 6: return ©"Saturday"; break; 
default: return @""; break; } 
return @""; 
T~ 

Per ora abbiamo sufficientemente strutturato la 
nostra interfaccia grafica, dobbiamo ora realizzare 
un sistema per gestire le nostre informazioni in 
modo strutturato e facilmente modificabile. 



NSMutableArray le impedisce pero di essere la soluzione 
piu performante rispetto ad NSArray, sia per i mec- 
canismi interni necessari per farla operare, che in ter- 
mini di occupazione di memoria a causa del codice 
aggiuntivo inserito al suo interno sotto forma di me- 
todi e altre strutture aggiuntive. Per fortuna converti- 
re una struttura di un tipo all'altro nel caso si sia rive- 
lata la scelta meno adatta e un'operazione relativa- 
mente indolore (piu leggera da NSArray a NSMuta- 
bleArray, viceversa piu complessa). Nel nostro caso, 
per ridurre il numero di righe di codice da digitare, 
utilizzeremo NSMutableArray, per gestire i vari task 
delle singole giornate, mentre un NSArray per rag- 
gruppare le informazioni relative ai sette giorni della 
settimana. 



NSARRAY 

E NSMUTABLEARRAY 

Quando si mostra il contenuto di una tabella e neces- 
sario accedere in qualche modo al componente Mo- 
del del pattern MVC, mentre la tabella incarna il View 
(e il Controller): a seconda delle necessita,si deve sce- 
gliere tra una struttura dati di tipo statico, immutabi- 
le dopo la sua creazione o dinamico (nella documen- 
tazione queste classi contengono generalmente il ter- 
mine mutable). Tra le strutture disponibili vengono 
spesso adoperate NSArray e NSMutableArray, facen- 
ti parte de\ia\ibYenaFoundation.framework; la prima 
e una classe il cui scopo e quello di contenere un elen- 
co di istanze di altre classi, impedendone pero qua- 
lunque modifica successivamente alia sua creazione 
in termine di numero e istanza: non e quindi possibi- 
le cancellare oppure inserire nuovi elementi; NSMu- 
tableArray e semplicemente una versione opportu- 
namente modificata di NSArray (e infatti una sua clas- 
se direttamente derivata) che consente inserimenti, 
in praticamente ogni posizione, testa, coda e nel mez- 
zo, e cancellazioni in maniera completamente libera. 
La scelta di quale struttura sia la piu adatta in un de- 
terminate contesto e un'operazione generalmente 
immediata: se il numero di celle pub cambiare nel 
tempo, prevalentemente ad opera delFinterazione 
dell'utente, la scelta in genere cade su NSMutableAr- 
ray per evitare inutili operazioni di cancellazione e ri- 
popolamento della struttura dati: inserire un nuovo 
oggetto in un NSMutableArray e una singola opera- 
zione, mentre nel caso di un NSArray comporta una co- 
pia profonda della struttura precedente, con un nu- 
mero di iterazioni quasi sempre pari al numero di ele- 
menti presenti (effettuati con un ciclo/or oppure uti- 
lizzando la fast enumeration ad esempio). La rimo- 
zione di un elemento da un NSMutableArray e anche 
in questo caso ottenuta con una singola operazione, 
mentre nel caso de\Y NSArray cio comporta sempre 
effettuare una copia profonda nella quale viene igno- 
rato T elemento da cancellare. La grande flessibilita di 



niSDICTIOMARY E 
niSMUTABLEDICTIOMARY 

Ora che abbiamo definito quale struttura dati con- 
terra i nostri elenchi di cose da fare, si pone il proble- 
ma di come rappresentare il singolo task della nostra 
todo list: analizzando la sua struttura identifichiamo 
alcune informazioni che identificherebbero il suo sta- 
to: una descrizione, che mostreremo nella textLabel 
e lo stato {Da fare, Fatto, Dimenticato) che vena utilizzato 
per le UILabel di tipo descriptionTextLabel. E possibi- 
le utilizzare diverse soluzioni in questo contesto: po- 
tremo creare una classe di tipo NSObjecte al suo interno 
inserire due campi di tipo NSString, oppure delle struct, 
ma per fare qualcosa di diverso dal solito approccio 
Object Oriented, adopereremo una classe presente in 
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Fig. 4: Una serie di sezioni con tre righe per ognuna 



ULTERIORI 
APPROFONDIMENTI 

Per approfondire questi 
concetti consultare la 
guida chiamata Table View 
Programming Guide for 
iPhone OS disponibile su 
sito developer.apple.com o 
all'interno della 
documentazione fornita 
con XCode. 
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FOUNDATION. 
FRAMEWORK 

All'interno di 
Foundation, framework 
troviamo decine di classi, 
tra cui NSDictionarye 
NSMutableDictionary, 
NSarraye NSMutableArray, 
NSStringe 
NSMutableString, NSData 
e NSMutableData, NSDate 
e NSError. e probabilmente 
la libreria che utilizzerete 
maggiormente. 



Objective-C disponibile nell'SDK, chiamata NSMuta- 
bleDictionary. La classe NSMutableDictionary (e la 
sua versione "statica", NSDictionary) e un'altra delle 
classi rese disponibili daftakbren^Foundatton. framework, 
e permette di creare istanze in cui viene inserito uno 
o piu valori con relative chiavi (ogni coppia viene de- 
finita come entry), tali chiavi svolgono quindi il com- 
pito di identificare univocamente un oggetto tra quel- 
li presenti airinterno dell' NSDictionary, consenten- 
done l'accesso in maniera estremamente intuitiva. 
Per realizzare un oggetto di tipo NSMutableDictionary 
e necessario inizializzarlo con una serie di chiavi e di 
valori a queste associati, in corrispondenza uno-a- 
uno, raggruppati all'interno di due array (di tipo NSAr- 
ray); gli stati possibili saranno "fatto", "da fare", "di- 
menticato", mentre il testo, owiamente, variera a se- 
conda delFazione da effettuare. Scegliere tra NSMu- 
tableDictionary e la sua controparte immutabile NSDic- 
tionary segue lo stesso procedimento decisionale uti- 
lizzato per NSArray; dal punto di vista delle presta- 
zioni e sicuramente un approccio piu pesante rispet- 
to alia realizzazione di una classe derivata da NSObject, 
ma in questo contesto e stato un pretesto per intro- 
durre queste strutture dati e presentare ulteriori clas- 
si fornite nell'SDK. 

NSArray *keys = [NSArray 

arrayWithObjects:@"action",@ M status",nil ]; 
NSArray * values = [NSArray 

arrayWithObjects:@"Chiamare Simone",@"Da Fare",nil]; 
//Definiamo e inizializziamo il dizionario 
NSMutableDictionary *myDict = [[NSMutableDictionary 
alloc] initWithObjects: values forKeys:keys]] 



In questo modo myDict conterra due coppie, una 
con la chiave "status", che assumera in questo caso il 
valore "Da Fare", mentre l'altra "Chiamare Simone" 
associata alia chiave "action". Per accedere ai valori 
associati alle chiavi presenti in myDict bastera utiliz- 
zare il metodo valueForKey: 



//otteniamo lo stato associato (fatto, da fare,dimenticato) 
NSString * myStatus = [myDict valueForKey :@"status"]; 
//otteniamo il task associato (@"Chiamare Simone") 
NSString * myAction = [myDict valueForKey :@"action"]; 

Owiamente, un NSMutableDictionary (come anche 
NSDictionary) puo contenere qualunque oggetto 
Objective-C e un numero teoricamente infinito di 
coppie chiave-valore. 



POPOLARE LA TABELLA 

Per popolare il nostro elenco dovremo prima creare 
T array che conterra le giornate, poiche sara immuta- 
bile utilizzeremo un NSArray di sette indici (si ricor- 
da accessibili da 0 a n-1), airinterno di ognuna di 



questi sette indici porremo un NSMutableArray, che 
ci consentira di variarne il numero di elementi, i 
nostri task, rappresentati come e stato detto da 
istanze di NSMutableDictionary, nella maniera piu 
veloce possibile. Dichiariamo giorniSettimana quale 
array statico prima del metodo viewDidLoad, e pro- 
cediamo inizializzandolo: 

NSArray *giorniSettimana; 
- (void)viewDidLoad { 
[super viewDidLoad]; 
NSLog(@"viewdidload"); 
self. title = @"ToDo List"; 
giorniSettimana = [[NSArray alloc] 
initWithObjects: [NSMutableArray array], [NSMutableArray 
array], [NSMutableArray array], [NSMutableArray 
array], [NSMutableArray array], [NSMutableArray 



array], [NSMutableArray array], nil ]; 


//Inseriamo nel giorno di domenica (indice 0) una 




serie di azioni 


[self insertAction 


:@"Chiamare Simone" 




withStatus:@"da fare" inDay:0]; 


[self insertAction 


:@"Comprare Latte" 


withStatus:@"dimenticato" inDay:0]; 


[self insertAction 


:@"Registrare Telefilm" 




withStatus:@"fatto" inDay:0]; 


//Inseriamo nel giorno di martedi (indice 2) una serie 




di azioni 


[self insertAction 


:@"Palestra" withStatus:@"da fare" 




inDay:2]; 


[self insertAction 


:@"Inviare Email" withStatus: 




@"non fare" inDay:2]; 


[self insertAction 


:@"Chiamare Gianni" 


withStatus:@"dimenticato" inDay:2]; 



Poiche, come abbiamo affermato precedentemente, 
NSArray e una struttura dati immutabile, dovremo im- 
postarne i contenuti in fase di inizializzazione, cio av- 
viene invocando il metodo iniWithObjects. Quest'ul- 
timo accetta un array di oggetti, terminato dal sim- 
bolo nil: inserendo sette istanze di NSMutableArray 
abbiamo cosi reso questa struttura dinamica nei con- 
tenuti. Ci sarebbero state differenze sostanziali se aves- 
simo utilizzato un NSMutableArray per Y elenco dei 
giorni? Non in questo caso e non in termini di codice, 
ma sicuramente in termini di prestazioni, quando si ini- 
zia a lavorare su strutture dati molto piu popolate e 
buona norma pensare a queste semplici ottimizza- 
zioni che spesso possono rendere meno oneroso in 
termini di risorse e prestazioni il vostro software. 
Come viene affermato dalla documentazione relati- 
va alia classe, NSArray mantiene un legame strong, 
forte, con gli oggetti che vengono inseriti al suo inter- 
no invocando su di essi un retain, e, venendo a cono- 
scenza di questo comportamento non e stato neces- 
sario utilizzare la tipica procedura alloc/init {[[NSMu- 
tableArray alloc] init]) nella fase di inserimento, ab- 
biamo infatti utilizzato il convenience constructor, un 
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costruttore che non effettua alloc/retain sull'istanza 
creata, e che per tale motivo portera all'autorelease 
dei singoli oggetti, ma, poiche questi riceveranno un 
retain non saranno deallocati. Se avessimo utilizzato 
alloc+init, ogni oggetto avrebbe avuto un retainCount 
pari a due, uno per Finizializzazione e uno dovuto al- 
rinserimento airinterno dell' array, impedendo quin- 
di la completa deallocazione dell'array quando su di 
questo richiameremo il metodo release (gli oggetti al 
suo interno avranno un retainCount pari a uno inve- 
ce che zero, come richiesto per la completa dealloca- 
zione della struttura dati). Ora che abbiamo creato un 
array di sette indici, ognuno contenente un NSMuta- 
bleArray, realizziamo un semplice metodo per inseri- 
re alTinterno dei giorni i task (che rappresentiamo con 
NSMutableDictionary) : 

(void)insertAction:(NSString *)action withStatus: 

(NSString *)status inDay:(int)day { 
NSArray * values = [NSArray 

arrayWithObjects:action,status,nil]; 
NSArray *keys = [NSArray 

arrayWithObjects:@"action",@"status",nil ]; 
[((NSMutableArray *)[giorniSettimana objectAtlndex: 

day]) addObject: [[NSMutableDictionary alloc] 
initWithObjects:values forKeys:keys]]; 



NSMutableArray 
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Fig. 5: Ecco come sono state strutturate le informazio- 
ni che vogliamo gestire 



Non allarmatevi se riceverete un warning che infor- 
ma della mancata presenza del metodo, bastera inse- 
rire la sua signature (-(void)insertAction: (NSString fac- 
tion withStatus: (NSString *)status inDay:(int)day) se- 
guita da un punto e virgola prima della riga @end al- 
Tinterno del file rootViewcontroller.fi. Poiche il nu- 
mero di utilizzi di questo metodo e ridotto, si e scelto 
di non ottimizzare in alcun modo Futilizzo dell'array 
keys, essendo una struttura che non viene in alcun 
modo modificata durante il tempo di vita della nostra 
applicazione, potrebbe infatti essere sostituitautiliz- 
zando la direttiva#define, evitando quindi qualunque 
inizializzazione di istanze (in questo caso una per ogni 
invocazione del metodo). II comportamento del me- 



todo e abbastanza intuitivo: vengono passate due 
stringhe che contengono il task e il suo stato, infine 
Tindice del giorno da utilizzare (anche in questo ca- 
so si potevano usare i #define per rendere il codice piu 
leggibile alFinterno di viewDidLoad); viene prelevato 
1'oggetto di giorniSettimana presente in posizione i-esi- 
ma, effettuato il casting a NSMutableArray per con- 
sentire al sistema di code completition di mostrarci 
solo i metodi coerenti con tale classe (infatti objectA- 
tlndex restituisce un'istanza di tipo id che rende inu- 
tilizzabile tale funzionalita, ne avevamo parlato in uno 
dei primi articoli dedicati alia programmazione iPho- 
ne) e inserito al suo interno un NSMutableDictionary 
contenente le due coppie con chiavi action e status. 



AGGIORNAMENTI 

Cosa ci resta da fare? Per come abbiamo strutturato i 
nostri dati identificheremo con le sezioni i singoli gior- 
ni della settimana, mentre le righe saranno i singoli 
NSMutableDictionary in esse presenti. Prima dob- 
biamo modificare il valore restituito da tableview: 
numberOfRowsInSection: in modo che fornisca il cor- 
retto numero di righe presenti nella sezione/ giorno. 
Bastera invocare il metodo count su ogni singolo og- 
getto del nostro array: 

- (NSInteger)tableView:(UITableView *)tableView 

numberOfRowsInSection :(NSInteger)section { 
return [((NSMutableArray *) [giorniSettimana 

objectAtIndex:section]) count]; } 

Per popolare la tabella bastera ottenere le informa- 
zioni action/status per ogni NSMutableDictionary pre- 
sente nelle varie sezioni/giorni: 

- (UITableViewCell *)tableView:(UITableView *)tableView 

cellForRowAtIndexPath:(NSIndexPath *)indexPath {... 
NSString *action = [(NSMutableDictionary 

*) [((NSMutableArray *)[giorniSettimana 
objectAtlndex :indexPath. section]) 
objectAtlndex: indexPath. row] valueForKey:@"action"]; 
NSString *status = [(NSMutableDictionary *)[((NSMuta 
bleArray *) [giorniSettimana 
objectAtlndex: indexPath. section]) 
objectAtlndex: indexPath. row] valueForKey: ©"status"]; 
cell. textLabel. text = action; 
cell. detailTextLabel. text = status; 
return cell; } 



CONCLUSIONI 

Nel prossimo articolo introdurremo altri concetti e 
tecniche per utilizzare la tabella, parleremo di can- 
cellazioni, inserimenti e altre operazioni. 
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GESTIONE DELLE 
CELLE NELLE TABELLE 

IN QUESTO ARTICOLO TRATTIAMO DELLE VARIE FUNZIONALITA OFFERTE DALL'SDK PER 
INSERIRE E CANCELLARE UNA O PIU RIGHE NELLE TABELLE: ELEMENTO FONDAMENTALE NELLA 
COSTRUZIONE DELLE INTERFACCE, SIA PER L'INPUT CHE PER LA VISUALIZZAZIONE DEI DATI 




0 



REQUISITI 



Conoscenze richieste 



u 00p 



MacOSX 10.5.4 o 
superiore, XCode 



Impegno 



0000 



NelFarticolo precedente abbiamo prima 
mostrato come si popola una tabella utiliz- 
zando una struttura statica, un array, e succes- 
sivamente abbiamo realizzato un metodo per popo- 
larne una utilizzando una struttura dinamica (di tipo 
NSMutableArmy): 

-(void)insertAction : (NSString *)action 

withStatus:(NSString *)status inDay:(int)day { 
NSArray * values = [NSArray 

arrayWithObjects: action, status,nil]; 
NSArray *keys = [NSArray 

arrayWithObjects: @"action",@"status", nil ]; 
[((NSMutableArray *)[giorniSettimana object 

Atlndex:day]) addObject: [[NSMutableDictionary 
alloc] initWithObjects: values forKeys:keys]]; 



Poiche il metodo che abbiamo mostrato non e 
invocabile, in risposta alia pressione di un pulsante 
o di un altro componente, non essendo di tipo 
IBAction (che ricordiamo essere un tipo di metodo 
che non accetta ami parametri se non il compo- 
nente grafico che lo ha invocato), dobbiamo per- 
correre un'altra strada per poter consentire con 
facilita Fesecuzione di una qualunque modifica in 
risposta all'interazione dell'utente: esistono per 
nostra fortuna svariate tecniche per effettuare cio, 
una di queste consiste nel modificare la struttura 
della tabella fornendo campi di testo e pulsanti 
necessari per modificare i contenuti della struttura 
dati che utilizziamo, e un'altra invece si realizza 
presentando un ulteriore UlViewController con 
relativa UlView, potremo anche presentare un 
AlertView customizzato; utilizzeremo questa terza 
procedura per aggiungere un nuovo evento. 



LA NAVIGAZIONE 
TRA "SCHEDE" 

L'utilizzo delFiPhone e principalmente basato 
sul concetto di consultazione progressiva di 
informazioni, come e stato spiegato quando 



abbiamo trattato dei passaggi necessari per arri- 
vare alia scheda di dettaglio di una serie di tabel- 
le. La navigazione e una funzionalita fornita dal 
componente che contiene la nostra tabella rea- 
lizzata nel file RootViewController.h/.m e nel rela- 
tivo file .xib, di tipo UINavigationController: se 
andiamo infatti ad esplorare le variabili presenti 
nel file nomeprogettoAppDelegate.h possiamo 
notare che ne e presente una di tipo 
UINavigationController, di tipo IBOutlet, chia- 
mata navigationContr oiler, che nel corpo del 
metodo applicationDidFinishLaunching, e uti- 
lizzata dal contenitore principale, la variabile 
window, come fonte della view da mostrare a 
schermo. In pratica, cosa viene realizzato auto- 
maticamente quando si crea un progetto di que- 
sto tipo navigation-based? La UlWindow contie- 
ne al suo interno una istanza di un 
UINavigationController, che a sua volta include 
una tabella; la presenza del navigation controller 
ci permette con estrema facilita di gestire inseri- 
menti, e owiamente rimozioni, di un numero 
virtualmente illimitato di ulteriori 
UlViewController (nel cui interno sono presenti 
quindi UlView): in questo modo e possibile rea- 
lizzare un complesso sistema di navigazione, che 
potremo dire "a schede" (con il quale intendiamo 
il binomio UlViewController e relativo UlView). 
Riguardo F UINavigationController, oltre a gesti- 
re la navigazione, consente di inserire dei pul- 
santi nella sua barra superiore, chiamata naviga- 
tionBar. Parleremo di questi aspetti successiva- 
mente, ma era necessario presentare almeno 
queste minime informazioni perche F UINaviga- 
tionController verra utilizzato quando dovremo 
implementare i pulsanti per effettuare le cancel- 
lazioni e gli inserimenti degli eventi. 



NSSTRING 

Prima di iniziare e doveroso trattare delle strin- 
ghe. In uno degli articoli precedenti, dove ave- 
vamo trattato della gestione della memoria, e 
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degli utilizzi di retain/release avevamo eviden- 
ziato che le stringhe del tipo NSString non erano 
soggette a queste regole, avevamo infatti utiliz- 
zato negli esempi istanze di NSMutableString; e 
ormai necessario aprire una parentesi e spiega- 
re perche NSString si esenta dalla gestione delle 
memoria dinamica, soprattutto perche e uno 
dei tipi di dato maggiormente utilizzati negli 
applicativi iPhone, dove spesso si richiede all'u- 
tente di compilare uno o piu campi di testo. La 
spiegazione e di estrema facilita: ogni istanza di 
NSString e sempre gestita come una costante 
rappresentata in Unicode, e non vi e quindi 
modo di modificare il contenuto di una variabi- 
le di questo tipo senza che venga, esplicitamen- 
te o implicitamente, sostituita con una nuova; 
se andassimo ad analizzare come vengono 
gestite due variabili in memoria il cui testo e 
identico, ad esempio "prova", scopriremo che 
queste due puntano alia stessa locazione di 
memoria, indifferentemente dal momento in 
cui le abbiamo istanziate, e alia classe in cui tale 
operazione awiene: lo scopo di tale comporta- 
mento e owiamente quello di ottimizzare il 
consumo di memoria, infatti in questo modo si 
possono avere migliaia di alias di un solo testo 
(n alias diversi e una sola variabile in memoria), 
e non migliaia di istanze con contenuto identi- 
co [n variabili in memoria) la cui occupazione e 
quindi di tipo lineare. Quando, durante la fase 
di compilazione, verranno analizzati i sorgenti, 
verra awiato un processo che come risultato 
fara in modo che tutte le variabili con stesso 
contenuto punteranno ad una sola locazione di 
memoria. Essendo quindi le stringhe delle 
costanti vengono esentate dalla necessita di 
retain/release/ autorelease e pertanto non ci si 
deve mai preoccupare di invocare tali metodi 
per gestirne la memoria. Ultima nota riguar- 
dante le stringhe: queste consentono di utilizza- 
re il simbolo di doppia uguaglianza per verifica- 
re se i loro caratteri sono identici, anche se 
Toperatore == non ha subito overloading, que- 
sto e dovuto al fatto che tale operatore verifica, 
per default, se i due indirizzi puntati da due 
variabili sono identici, e come appena spiegato 
cio e sempre vero se due stringhe hanno uguali 
caratteri. 

NSString *myString = @"prova"; 

NSString *myString2 = @"prova"; //punteranno in 

memoria alia stessa locazione 
if (myString = = myString2) {codice sempre 

eseguito} 

Cio non e vero quando utilizziamo due 
NSMutableString, in questo caso Tuguaglianza 
non avra Tesito sperato perche le due variabili 



puntano sempre a locazioni diverse; in questo 
caso e quindi necessario utilizzare il metodo 
isEqualTo String. 

NSMutableString *myString = [NSMutableString 

stringWithString:@"prova"]; 

NSMutableString * myString2 = [NSMutableString 

stringWithString:@"prova"]; 

if (myString == myString2) NSLog(@"sono uguali"); 

//non viene mai verificata come condizione 
if ([myString isEqualToString: myString2]) 

NSLog(@"sono uguali con equaltostring"); 

Anche se e quindi lecito utilizzare Y== con le 
stringhe di tipo NSString si rischia, in caso di 
dimenticanza, di utilizzarlo anche con le NSMu 
tableString, o peggio, con istanze di altri oggetti: 
il consiglio e quindi di usare isEqualtoString per 
evitare possibili errori. 

Poiche dovremo prelevare del testo da uno o piu 
campi, non avere questa consapevolezza 
potrebbe creare problemi inizialmente a quei 
lettori meno attenti/preparati, inducendoli a 
passare ore cercando di deallocare queste varia- 
bili senza successo ottenendo crash continui. 



I POSSIBILI STATI 
DELLE CELLE DI UNA 
TABELLA 

Ogni cella di una tabella si comporta come un 
automa a stati finiti, puo passare quindi tra un 
numero limitato di diverse configurazioni, 
ognuna delle quali generalmente condiziona il 
suo aspetto. Successivamente, se coerente con il 
comportamento atteso, anche il contenuto 
della relativa "riga" associata nella struttura dati 




NSSTRING 

Ogni stringa di tipo 
NSString e una costante, 
quindi non e soggetta ad 
alcuna gestione da parte 
dell'utente e neppure dal 
sistema di gestione 
automatica delle risorse; 
inoltre tutte quelle stringhe 
che hanno identico valore 
puntano ad una stessa 
locazione di memoria. 
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Fig. 1: Due stringhe con ugual contenuto di testo punteranno alia stessa locazione in 
memoria. Nei nostro esempio: varl e var2 
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UGUAGLIANZA 
TRA STRINGHE 

L'utilizzo di == quale 
operatore per verificare 
I'uguaglianza tradue 
stringhe di tipo NSString 
funziona, nonostante non 
sia soggetto ad 
overloading, poiche verifica 
se i due indirizzi sono 
identici. Situazione vera 
quando due stringhe 
puntano ad una stessa 
locazione di memoria, e cio 
avviene perche stringhe 
con contenuti uguali 
puntano alia stessa 
memoria. 



collegata: abbiamo uno stato "normale" duran- 
te il quale si effettuano le semplici operazioni di 
scorrimento e di selezione delle "righe" 
(UITableViewCellEditingStyleNone), poi uno 
stato di "modifica" che pub essere di cancella- 
zione, oppure di inserimento (esiste anche un 
terzo, quello di riordino ma che non viene uti- 
lizzato in questo modo), il primo prende il 
nome di UITableViewCellEditingStyleDelete, 
mentre il secondo UITableViewCellEditing- 
Stylelnsert: tali "stati" sono quindi degli indica- 
tori per consentire di valutare se una determi- 
nata cella e al momento, visivamente parlando, 
in uno stato di modifica oppure no; esiste inol- 
tre una proprieta della cella, editing, di tipo 
booleano, il cui scopo e indicare Teffettivo stato 
della cella, teoricamente sarebbe infatti possibi- 
le impostare una cella con uno stile visivo di 
modifica e renderla invece non editabile; gene- 
ralmente editing non viene consultata perche ci 
si affida al fatto che una cella con un determi- 
nate stile ha gia automaticamente imp o stato 
tale valore a true o false] se si utilizzano i meto- 
di relativi alia tabella, quelli che vengono gene- 
rati automaticamente dal wizard, non avrete 
necessita di valutarla. Infatti noteremo nel pros- 
simo paragrafo che semplicemente verra con- 
sultato lo stile visuale e non editing. 
Generalmente lo stato di cancellazione si evi- 
denzia in due modi: o si presenta con un pul- 
sante rosso, simile ad un segnale di stop, sul lato 
sinistro della cella che, quando premuto, fara 
comparire un bottone sul lato destro della cella 
per confermare tale operazione, oppure con 
solamente un bottone sulla destra; questo 
secondo aspetto si presenta quando si effettua 
la cancellazione effettuando lo scorrimento del 
dito da destra verso sinistra sulla cella desidera- 
ta. Molti metodi da utilizzare per gestire tali 
operazioni vengono generati automaticamente 
dal wizard del progetto, bastera decommentarli 
e personalizzarli a seconda delle proprie neces- 
sita. 



GESTIRE LE 
CANCELLAZIONI 

Gestire la cancellazione di una o piu celle, 
quando e necessario rispondere airinterazione 
con Tutente, si rivela per nostra fortuna, 
un'operazione estremamente semplice; per 
quanto riguarda Tutilizzatore deirinterfaccia, 
tale operazione viene invocata automatica- 
mente quando si scorre il dito sulla cella con 
un movimento da destra verso sinistra, oppure 
premendo un pulsante, generalmente presente 
in alto a destra, con label edit, che mostrera 



successivamente un pulsante rosso sul lato 
sinistro di ogni riga; dal punto di vista del pro- 
grammatore, per mostrare il pulsante di edit in 
alto a destra, bastera inserire la seguente riga 
airinterno del metodo viewDidLoad, owia- 
mente dopo la chiamata al metodo della classe 
padre: 

[super viewDidLoad]; 
self.navigationltem.rightBarButtonltem = 

self.editButtonltem; 

In questo modo si e impostato il pulsante 
destro presente nella navigationBar del 
UINavigationController con uno predefinito, 
presente in tutti gli UlViewController, il cui 
comportamento, preimpostato, e quello di 
invocare il metodo (void) setEditing: (BOOL) 
editinganimated: (BOOL) animated (come 
esplicitamente descritto nelle documentazio- 
ne di UlViewController), per la UITableView 
questo metodo e stato gia implementato inter- 
namente alia classe e non sara necessario 
crearlo o modificarlo: prowedera ad iterare per 
tutte le righe e mostrare il pulsante rosso sul 
lato sinistro di ognuna di queste (se e abilitata 
alia cancellazione). II pulsante e, per informa- 
zione, appartenente alia classe UIBarButton- 
Item e, per supportare la creazione di una cella 
nel prossimo paragrafo, la utilizzeremo per 
istanziare un bottone ad hoc (quello nella 
parte sinistra). Abbiamo ora reso disponibili 
due modalita di cancellazione, quella multipla, 
il cui utilizzo termina con Tulteriore pressione 
del pulsante presente a destra nella 
navigationBar, che assume il testo "done" suc- 
cessivamente alia prima interazione, e quella 
singola, scorrimento destra- sinistra del dito 
sulla cella. 

Ora e necessario abilitare la cancellazione di 
una o piu celle: cosa che si realizza implemen- 
tando un metodo per effettuare una o piu can- 
cellazioni. Per supportare questa operazione, 
bastera decommentare, il metodo che riportia- 
mo di seguito: 

-(void)tableView:(UITableView*)tableView 

commitEditingStyle:(UITableViewCellEditingStyle) 
editingStyle forRowAtIndexPath:(NSIndexPath 

*)indexPath { 



if (editingStyle = = 

UITableViewCellEditingStyleDelete) 

{ 

// Delete the row from the data source. 
//[tableView deleteRowsAtlndexPaths: [NSArray 

arrayWithObject: indexPath] 
withRowAnimation:UITableViewRowAnimationFade]; 



iPhone programming 



^PuntolnformaticD I [jjjf! 



49 ► 



iPhone programming T 



Le tecniche per inserire e cancellare righe da una tabella 



> 

> 

Decommentando questo metodo si rendono 
cancellabili tutte le celle; se si volesse creare la 
logica per proteggerne una o piu si dovra 
decommentare il seguente metodo, sempre 
generato dal wizard del progetto, e decidere, a 
seconda della cella ricevuta, se restituire YES 
oppure NO: 

- (BOOL)tableView:(UITableView *)tableView 
canEditRowAtIndexPath:(NSIndexPath *)indexPath 

{ 

// Return NO if you do not want the specified 

item to be editable. 

return YES; 
T~ 

Tornando al metodo utilizzato per modificare 
la tabella, analizzando il comportamento di 
default fornito dagli ingegneri Apple, si notera 
che viene prima verificato lo stile attuale della 
cella sulla quale tale metodo e stato invocato e, 
se corrisponde a UITableViewCellEditing- 
StyleDelete, si pub prowedere a cancellare la 
"riga" presente nella nostra tabella. La parte di 
codice che quindi dovremo modificare e quel- 
la precedente alia seguente riga (che dovrete 
decommentare se fosse commentata): 

[tableView deleteRowsAtlndexPaths: [NSArray 

array WithObject: indexPath] 
withRowAnimation:UITableViewRowAnimationFade]; 

Questa chiamata prowede a cancellare visiva- 
mente la cella, infatti viene invocata sulla 
nostra tabella, tableView, ma se non prowede- 
remo a rimuovere anche la relativa entita nella 
nostra struttura dati avremo un'incoerenza tra 
model (la struttura dati usata, NSMutable 
Array) e view (le celle della tabella), il nostro 
software verra terminato con un crash molto 
esplicativo questa volta: 

Terminating app due to uncaught exception 
'NSInternallnconsistencyException', 
reason: 'Invalid update: invalid number 
of rows in section 0. The 

number of rows contained in an existing section 
after the update (3) must be equal 
to the number of 

rows contained in that section before 
the update (3), plus 

or minus the number of rows inserted or deleted 
from that section (0 inserted, 1 deleted). 

Bastera quindi aggiungere la seguente riga 
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Fig. 2: Ecco come si presents la modalita 
di cancellazione multipla 



prima delle cancellazione della cella della 
tabella: 

//Cancellazione dal MODEL 
[((NSMutableArray *)[giorniSettimana 

objectAtlndex: indexPath. section]) 
removeObjectAtlndex : indexPath . row] ; 

//Cancellazione dal VIEW 

[tableView deleteRowsAtlndexPaths: [NSArray 

array WithObject: indexPath] 
withRowAnimation:UITableViewRowAnimationFade]; 




RIFERIMENTI WEB 

Creazione dell'account, per 
scaricare I'SDK e 
consultare la 
documentazione: 
http://developer.apple. 
com/iphone/ 



Come si nota la gestione della cancellazione si 
e rivelata un'operazione molto semplice: ha 
comportato solo decommentare il metodo 
relativo e Taggiunta di una sola riga per far 
riflettere questa modifica anche alia struttura 
dati. 



GESTIRE GLI 
IIMSERIMEIMTI 

Esistono svariati metodi per aggiungere una 
"riga" nella nostra tabella, come abbiamo 
detto in precedenza, in questo tutorial utiliz- 
zeremo un UIAlertView customizzato; 
T UIAlertView e una UlView che generalmente, 
in maniera modale, quindi impedendo intera- 



► 50 



^PuntolnformaticD I [jjjf! 



iPhone programming 



Le tecniche per inserire e cancellare righe da una tabella 



T iPhone programming 




UIALERTVIEW 

Un componente di tipo 
(Mertl//ei/i/consente di 
presentare messaggi, 
con una o piu possibili 
scelte, in maniera modale, 
intercettando quindi 
I'interazione dell'utente. 




ULTERIORI 
APPROFONDIMENTI 

Per approfondire questi 
concetti consultare la 
guida chiamata Table View 
Programming Guide for 
iPhone OSdisponibile su 
sito developer.apple.com 
oall'interno della 
documentazione fornita 
con XCode. 



zione con gli altri componenti, presenta uno o 
due, bottoni mostrando un messaggio di testo 
e richiedendo una scelta: un esempio tipico e 
il messaggio che richiede di autorizzare la 
consultazione della posizione del telefono per 
una qualche funzionalita di localizzazione 
che si trova in numerosi applicativi. Noi lo 
modificheremo per le nostre necessita utiliz- 
zando delle funzioni nascoste, non pubblica- 
mente rese disponibili da Apple, che possono 
essere utilizzate per inserire un qualunque 
numero di campi di testo (UITextField) al suo 
interne 

Dovremo effettuare tre operazioni, la prima 
consiste nell'inserire un pulsante nella 
navigationBar sul lato sinistro che ci consen- 
ta di inserire una nuova scheda, presentando- 
ci quindi Y UIAlertView; la seconda e imple- 
mentare il metodo addltem, che prowedera a 
creare V UIAlertView, la terza sara 
Timplementazione di un secondo metodo in 
risposta alia conferma della creazione dell'e- 
vento, successivamente alia pressione 
de\Y UIAlertView. 

Per poter effettuare la prima operazione, 
quella di visualizzazione del pulsante sulla 
sinistra, prowediamo aggiungendo le seguen- 
ti righe sempre nel metodo ViewDidLoad, 
immediatamente dopo il comando che abbia- 
mo utilizzato per mostrare il pulsante di can- 
cellazione: 

self.navigationltem.rightBarButtonltem = 

self.editButtonltem ; 



UIBarButtonltem *addButton = 

[[UIBarButtonltem 
alloc] initWithBarButtonSystemItem:UIBarButton 
System I tern Add target:self 
action : @selector(addItem : )] ; 



self.navigationltem.leftBarButtonltem = 

addButton; 



[addButton release]; 

II codice e molto semplice: si crea un'istanza 
di un bottone, come una normale istanza di 
un oggetto, lo si imposta con uno stile visuale 
che mostra il simbolo di piu (+) ad indicare 
Tinserimento, e si setta come target responsa- 
bile della gestione degli eventi il metodo 
addltem nella stessa classe in cui ci troviamo 
{self sta proprio ad indicare di utilizzare que- 
sta classe). 

Dopo aver associato il pulsante di sinistra, 
leftBarButtonltem, con il nostro bottone, 
dovremo ricordarci di rilasciare la risorsa, 



questo e dovuto al fatto che, avendo utilizzato 
alloc/init, avremo un retainCount di 1, 
Tassegnazione del pulsante di sinistra, come 
segnalato dalla documentazione, prowede ad 
effettuare un retain. 

Quindi, al termine del metodo, se non effet- 
tuassimo un release, avremo un retainCount 
di 2, che non verrebbe mai deallocato, neppu- 
re nel caso rilasciassimo il UIViewNavigator, 
diventando quindi leak. Passiamo ora alia 
seconda fase: 

- (void)addItem:sender { 



UIAlertView *alert = [[[UIAlertView alloc] 

initWithTitle:@"Create new Event" message:©"" 

delegate:self 
cancelButtonTitle:@"Cancel" 
otherButtonTitles: @"Submit", nil 

] autorelease]; 



[alert addTextFieldWithValue:@ "Sunday" 

label:@"Day of the week"]; 
[alert addTextFieldWithValue:@"" label:@"What"]; 

[alert addTextFieldWithValue:@"" 

label:@"Status"]; 
[alert show]} 

L'implementazione del metodo addltem crea 
un UIAlertView con titolo "Create new Event", 
impostando due bottoni, uno di annullamen- 
to (con label Cancel) e uno di conferma (con 
label Submit); entra ora in gioco Tutilizzo di 
un metodo non pubblicato da parte di Apple 
associato alia classe UIAlertView, tale metodo 
addTextFieldWithValue, consente di inserire 
un numero illimitato di campi di testo che 
consulteremo quando confermeremo la crea- 
zione dell'evento. 

Per accedere a questi campi di testo dovremo 
utilizzare un altro metodo nascosto, 
[alertView textFieldAtlndex.'i], dove owiamen- 
te i e Tindice, partendo da 0, a cui e associato 
ogni campo, 0 per il campo del giorno della 
settimana, 1 per quello dell'azione, 2 per lo 
stato deirazione. 

Per quanto riguarda la pressione dei due pul- 
santi disponibili implementiamo il metodo 
alertView: clickedButtonAtlndex, invocato 
automaticamente quando premeremo cancel 
o submit. 

- (void)alertView: (UIAlertView *)alertView 

clicked Button AtIndex:(NSInteger)buttonIndex 

{ 

if (buttonlndex ! = 

[alertView cancelButtonlndex]) 
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space 



Fig. 3: L'UIAIertView che mostra i campi di input 



short day = 0; 
if ([((UITextField *)[alertView textFieldAtIndex:0]) 
.text isEqualToString:@"Sunday"]) day = 0; 
else if ([((UITextField *)[alertView 

textFieldAtlndex 
:0]).text isEqualToString:@"Monday"]) day = 1; 
else if ([((UITextField *)[alertView 

textFieldAtlndex 
:0]).text isEqualToString:@"Tuesday"]) day = 2; 
else if ([((UITextField *)[alertView 

textFieldAtlndex 
:0]).text isEqualToString:@"Wednesday"]) day = 



else if ([((UITextField *)[alertView 

textFieldAtlndex 

:0]).text isEqualToString:@"Thursday"]) day = 4; 
else if ([((UITextField *)[alertView 

textFieldAtlndex 
:0]).text isEqualToString:@"Friday"]) day = 5; 
else if ([((UITextField *)[alertView textFieldAt 
lndex:0]).text isEqualToString:@"Saturday"]) day 

= 6; 

[self insertAction: ((UITextField *)[alertView 
textFieldAtlndex: 1]). text withStatus:((UITextField 
*)[alertView textFieldAtIndex:2]).text inDay:day]; 



[(UITableView *)self.view reloadData]; // 
//oppure [tableView reloadData] se tableView e il 
nome dell'IBOutlet della tabella 

> 
} 
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Chiamare Simone da fare 


> 




Comprare Latte dimenticato 


> 




Reg ist r a r e Te I ef i I m f atto 
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Uscire con un amico Da fare 


> 




Monday 




Tuesday 






r 

Palestra da fare 


> 




Inviare Email non fare 


> 







Fig. 4: II risultato dell'inserimento 



Come prima operazione verifichiamo che non 
sia stato richiesto Tannullamento delFopera- 
zione, bastera verificare che buttonlndex, 
parametro passato AaWUIAlertView, corri- 
spondente aH'indice del pulsante premuto, 
non sia quello associato al tasto cancel; effet- 
tuiamo successivamente una semplice ricerca 
sul giorno della settimana inserito dall'utente 
nel primo campo di testo (indice = 0), come si 
pub notare e stato utilizzato il casting su 
[a lertViewtextFieldA tlndex: 0] . 
Quando abbiamo identificato il giorno, potre- 
mo finalmente aggiungere la nuova azione nel 
corretto giorno della settimana con il relativo 
stato. Anche in questo caso avremmo potuto 
utilizzare Toperatore di doppia uguaglianza 
per verificare quale giorno era stato digitato. 
Operazione finale, e comunque obbligatoria, 
consiste nel notificare la View, la nostra tabel- 
la, che e awenuta una modifica del Model, il 
nostro array. 

Riceverete numerosi warning in fase di com- 
pilazione, questo e dovuto al fatto che stiamo 
usando metodi non resi pubblici dalla classe 
UIAlertView: ricordiamo che non e possibile 
rendere privato un metodo ma solo nascon- 
derlo con alcuni artifici del linguaggio, quindi 
non c'e modo di impedirne effettivamente 
l'invocazione. 

Andrea Leganza 
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UNA SVEGLIA 
DIGITALE PER IPHONE 

IN QUESTO ARTICOLO MOSTRIAMO COME REALIZZARE UNA SVEGLIA DIGITALE 

CHE CI AWISERA Dl IMPEGNI E SCADENZE IMMINENTI. SARA L'OCCASIONE 

Dl APPROFONDIRE I CONCETTI LEGATI ALLA GESTIONE DELL'INTERFACCIA E DEL TIMER 





Conoscenze richieste 



u 009 



ft 



MacOSX 10.5.4 o 
superiore, XCode 



Impegno 



0000' 




..Hi Carrier ^ 12:58 AM 



] 
















SVEGLIA!!! 












Fig. 1: Al termine del progetto avremo realizzato una 
sveglia digitale 



In questo articolo mostreremo come realizza- 
re una sveglia digitale. Grazie a questo pro- 
getto avremo modo di introdurre alcune clas- 
si di estrema utilita: NSTimer, fornita dal fra- 
mework Foundation, che insieme a UIKit mppre- 
senta le fondamenta di tutte le applicazioni per 
iPhone, e AVAudioPlayer, presente nel framework 
AVFoundation, il cui scopo e consentire 
l'esecuzione di brani audio di "qualunque" 
dimensione. Poiche, come e risaputo, non e per- 



messo nell'iPhone mantenere un'applicazione 
in background, si potra utilizzare questa funzio- 
nalita di sveglia solo quando la nostra applica- 
zione e effettivamente in esecuzione. 



IL TIPO Dl PROGETTO 

Per realizzare questo software utilizzeremo un 
nuovo tipo di progetto fornito da XCode chiama- 
to Utility Application: gli applicativi che vengono 
identificati con questo termine sono costituiti da 
due UlViewController contenenti una singola 
UlView ciascuno, che si alternano in base alia 
pressione di un preciso tasto. II viewcontroller 
principale viene chiamato automaticamente 
MainViewContr oiler. 

II passaggio dall'una a l'altra schermata awiene 
con la pressione del pulsante i nel MainView, e 
con Tutilizzo di quello con label done, posiziona- 
to in alto a sinistra nella barra di navigazione di 
FlipsideViewController. II sistema utilizzato per 
effettuare lo switch e relativamente complesso e 
non ne parleremo in questo articolo. Essendo la 
terza serie di articoli prenderemo per scontate 
tutte le pratiche necessarie per effettuare la crea- 
zione degli IBOutlet e per prelevare le informazio- 
ni da tali oggetti. L'intera business logic verra 
implementata aH'interno del MainView 
Controller, nel quale abbiamo accesso anche ai 
contenuti del FlipsideViewController. 



IL COMPOIMEIMTE 
UIDATEPICKER 

Inserendo un componente del tipo UIDatePicker 
all'interno della nostra interfaccia grafica, nel 
FlipsideViewController, forniremo all'utente la 
possibility di selezionare una data, con una pre- 
cisione a nostra discrezione; in questo caso 
impostiamo, tramite Interface Builder, il formato 
completo (giorno, mese, anno, ore, minuti) set- 
tando mode al valore "Date and Time", la lingua 
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italiana utilizzando il campo locale, e la precisio- 
ns con il campo interval ad 1 minuto. 
UIDatePicker fornisce un metodo per ottenere la 
data selezionata, questa e un'istanza della classe 
NSDate e, quando torneremo al MainView prov- 
vederemo a memorizzarla in una cartella 
dell'iPhone, ed utilizzarla per verificare se 
l'allarme dovra essere eseguito. 



tando la data attuale, ottenuta richiedendo il 
valore del campo date dalla classe NSDate, con 
quella prelevata dalF UIDatePicker: 

- (void) handleTimer: (NSTimer *) timer { 
if ([alarmDate timeIntervalSincel\low]<=0) 

{ 

//viene eseguito il suono dell'allarme 




COMTROLLO NSTIMER 

Un timer e un sistema che permette di cadenza- 
re Tesecuzione di un metodo con precisi inter- 
valli; ogni timer viene eseguito in un thread 
distinto. Attenzione, un NSTimer non garantisce 
che Tesecuzione del metodo associato awenga 
sempre in un preciso istante, ma che awerra in 
un istante pari o successivo a quello desiderata, 
questa limitazione e dovuta al fatto che, trovan- 
doci in un ambiente multithread e multiprocess, 
dovremo condividere le risorse hardware con 
altri processi in esecuzione. In genere cio awiene 
utilizzando uno dei cosiddetti "algoritmi di sche- 
duling", i quali prowedono a fornire in maniera 
ciclica sufficiente tempo di calcolo sulla CPU a 
tutti i processi che ne facciano richiesta; potreb- 
be capitare quindi che, quando il nostro timer sia 
in procinto di scadere, awenga un evento fuori 
dal nostro controllo che interrompa o rallenti 
T esecuzione del nostro software per alcuni milli- 
secondi, impedendogli di effettuare in tempo 
l'esecuzione del metodo. La precisione dichiara- 
ta e di circa 50/100 millisecondi, ma e comunque 
non garantita per le motivazioni appena citate. 

NSTimer *timer = [NSTimer 

scheduledTimerWithTimelnterval : 1 
target: self 

selector: @selector(handleTimer: ) 
userlnfo: nil 

repeats: YES]; 

- (void) handleTimer: (NSTimer *) 

timer{ metodo invocato da NSTimer} 

Con questo codice abbiamo realizzato un timer 
che viene awiato ogni secondo (o nei millesimi 
successivi), che alio scadere deH'intervallo ese- 
gue il metodo handleTimer e che si ripete all'infi- 
nito. II metodo viene immediatamente awiato 
dopo la sua esecuzione e subisce un retain auto- 
matico. Quando, (e se), non avremo piu bisogno 
di questa istanza bastera invocare su di essa il 
metodo invalidate, che prowedera ad effettuare 
su di essa un release automatico. Per il nostro 
scopo questo metodo dovra verificare se e giunto 
il momento per eseguire l'audio delFallarme, 
operazione effettuabile semplicemente confron- 



} 



timelntervalSinceNow restituisce un valore positi- 
vo, i secondi mancanti alia data attuale, quando 
alarmDate e una data futura, mentre i valori sono 
negativi se alarmDate e ormai trascorso. 
Abbiamo dovuto utilizzare sia l'uguaglianza che 
il simbolo di minore uguale perche, come e stato 
detto, non si pub prevedere se il timer verra ese- 
guito nel preciso minuto in cui dovrebbe scattare 
F evento, o in uno dei successivi. 



LA MEMORIZZAZIOIME 
DELL'ORA DELL'ALLARME 

Dopo aver selezionato una data adoperando 
F UIDatePicker, prowederemo a memorizzarla in 
una cartella locale all'iPhone e a caricarla ogni 
volta che il nostro applicativo verra eseguito. 
Airinterno del telefono esistono alcune cartelle 
liberamente accessibili e modificabili nelle quali 
potremo salvare qualunque tipo di informazio- 
ne: tmp e Documents. La prima deve essere utiliz- 
zata per creare e gestire informazioni il cui 
tempo di vita e limitato alia singola esecuzione, 
mentre la seconda per tutti quei casi in cui un 
dato deve permanere per diversi awii dell' appli- 
cativo. Esistono svariati metodi per ottenere la 
corretta posizione di queste cartelle, che sono 
uniche per ogni software, utilizzeremo il metodo 
consigliato da Apple quando si realizza un pro- 
getto che utilizza la tecnologia Core Data (della 
quale tratteremo in un prossimo articolo) : 

- (NSString *)applicationDocumentsDirectory { 
return 

[NSSearchPathForDirectoriesInDomains(NSDocument 
Directory, NSUserDomainMask, YES) lastObject]; 

y~ 

Questo codice restituisce il path, una stringa che 
rappresenta la posizione completa della cartella 
Documents. Questo valore potra assumere valori 
diversi a seconda dell' applicativo, ma anche se vi 
troverete a utilizzare il tutto nel simulatore. 
Ii questo caso puntera ad una sottocartella defi- 
nita in: /Users/$NOMEUTENTE/Library/Application 
Support/iPhoneSimulator/User/Applications/, oppu- 




Fig. 2: II MainView 
Controller che mostera 
I'allarme 
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re nel telefono. Per creare un path completo 
comprensivo del nome del file bastera comporre 
una stringa utilizzando la seguente procedural 

NSString *archivePath = [[self 

applicationDocumentsDirectory] 
stringByAppendingPathComponent:@"sveglia.cfg"]; 



Con questa riga abbiamo realizzato con estrema 
semplicita un path per un file chiamato sveg- 
lia.cfg che verra salvato e caricato quando richie- 
sto. Per verificare se il file sveglia.cfg esiste gia 
alFinterno della cartella Documents, bastera 
semplicemente utilizzare il seguente metodo, 
fileExistsAtPath, fornito dalla classe NSFile- 
Manager, il quale restituira true in caso affermati- 
vo, false in caso negativo: 




ULTERIORI 
APPROFONDIMENTI 

Consultare la 
documentazione online 
denominata Exception 
Programming Topics for 
Cocoa per la gestione delle 
eccezioni e per I'elenco 
delle eccezioni di default. 



if ([[NSFileManager defaultManager] fileExistsAtPath: 

archivePath]) 

{ 

//il file esiste 



} 



else 



{ 



//il file non esiste 



} 



Queste informazioni verranno utilizzate per 
memorizzare la data in cui la sveglia dovra esse- 
re awiata in modo da recuperare e utilizzare tale 
informazione ad ogni awio. 



AVAUDIOPLAYER 

AVFramework, (Audio Video Foundation 
Framework), e un framework che consente di ese- 
guire e anche registrare brani audio 
AVAudioPlayer e una delle classi fornite da tale 
libreria che consente l'esecuzione di un singolo 
file audio (uno per istanza); AVAudioPlayer con- 
sente di mettere in pausa e interrompere un 
audio, avere informazioni sulla sua durata e sulla 
posizione in cui e al momento l'esecuzione, con- 
sente infine di monitorare i vari livelli di volume 
assunti dalF audio. Questa classe accetta tutti i 
formati supportati dalF iPhone: 

• AAC 

• HE-AAC 

• AMR (Adaptive Multi-Rate, a format for spee- 
ch) 

• ALAC (Apple Lossless) 

• iLBC (internet Low Bitrate Codec, another for- 
mat for speech) 

• IMA4 (IMA/ADPCM) 

• linear PCM (uncompressed) 



• u-law and a-law 

• MP3 (MPEG-1 audio layer 3 

II formato suggerito dalla documentazione e 16- 
bit, little-endian, linear PCM di tipo CAE E possi- 
ble convertire i proprio file audio in questo for- 
mato utilizzando il tool chiamato afconvert 
accessibile tramite la finestra di terminale di Mac 
OS: 

/usr/bin/afconvert -f caff -d LEI 16 {INPUT}{OUTPUT> 

Nel caso di esecuzione multipla viene consigliato 
l'utilizzo del formato IMA/ADPCM [IMA4] , mentre 
per Fascolto di file singolarmente suggerisce 
MP3, ALAC {Apple Lossless), AAC, IMA4. II primo 
file che viene eseguito accede direttamente alle 
risorse hardware, mentre i successivi saranno 
eseguiti via software. Apple raccomanda nella 
documentazione di utilizzare questa classe per 
eseguire qualunque tipo di effetto audio, a meno 
di avere necessita di gestire in modo distinto i 
canali stereo, di avere una sincronizzazione pre- 
cisa, o quando si utilizzano file provenienti da 
flussi esterni, come awiene ad esempio per le 
web radio. Apple fornisce numerosi framework 
oltre ad AVFramework: 

• Media Player framework: per eseguire brani 
musicali, audio book, podcasts; 

• Audio Toolbox framework: per eseguire 
audio con precise necessita di sincronizzazio- 
ne, o analisi o conversione, incluso maggiore 
controllo sulle fasi di registrazione; 

• Audio Unit framework: per utilizzare plugin 
audio; 

• OpenAL framework: viene consigliato come 
la migliore soluzione per eseguire e gestire 
musiche per i videogiochi, e utilizza OpenAL 
1.1. 

Tornando ora a AVAudioPlayer, nel nostro proget- 
to utilizzeremo un loop audio, il tipico scandire 
del tempo di un orologio a tempo, e un suono 
che awisera delFallarme. Prima di effettuare 
qualunque operazione e necessario aggiungere 
AVFoundation.framework tra i framework che uti- 
lizzera il progetto e importarlo aH'interno di 
MainViewController (#import <AVFoundation/AV 
Foundation.h>) . II codice per eseguire un file 
audio e relativamente breve: prima prowediamo 
a identificare il path completo della risorsa che ci 
interessa, (un file mp3 in questo caso), poi cree- 
remo un'istanza di AVAudioPlayer, imposteremo il 
volume, il numero di esecuzioni e lo awieremo: 

NSString *path = [[NSBundle mainBundle] 

pathForResource:@"clock" ofType:@"mp3"]; 
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AVAudioPlayer player = [[AVAudio Player alloc] 
initWithContentsOfURL:[NSURL fileURLWithPath:path] 

erronnil]; 

player.volume = 0.4f; 
[player prepareToPlay]; 



[player setNumberOfLoops:-!]; 



[player play]; 




Fig. 1: La procedura necessaria per importare il fra- 
mework 



AVAudioPlayer ha un costruttore che accetta un 
URL, (che in questo caso sara la posizione assun- 
ta nel nostro software dalla risorsa chiamata 
clock.mpS), e una variabile per memorizzare pos- 
sibili errori (in questo progetto la abbiamo igno- 
rata, impostandola a nil). II campo volume e un 
float 'A cui intervallo e [0,1], dove con 0 si intende 
il silenzio, mentre con 1 il massimo valore con- 
sentito; il metoto prepareToPlay memorizza 
F audio in un buffer prima di awiare Fesecuzione 
in modo da evitare interruzioni dovute al caching 
del file durante il play; setNumberOfLoops: puo 
assumere un qualunque valore negativo per indi- 
care un loop infinito, 0 per una singola esecuzio- 
ne, i per (i+T) ripetizioni, inserendo 1 si avranno 
quindi due awii successivi del suono. Se volessi- 
mo monitorare quando un suono e terminato 
bast era aggiungere il me to do audioPlayerDid 
FinishPlaying: alFinterno della nostra classe, 
appartenente al protocollo AVAudioPlayerDelegate: 

- (void)audioPlayerDid FinishPlaying: (AVAudioPlayer 

*)player successfully:(BOOL)flag { 
//il suono e terminato 



esaustiva quei costrutti che consentono di cattu- 
rare uno o piti errori generati da una non corret- 
ta esecuzione del proprio applicativo. 
Un'eccezione e il risultato di un comportamento 
anomalo, software o hardware, che il program- 
matore dovrebbe gestire per evitare che il pro- 
prio applicativo vada in crash e venga terminato. 
Per sapere se un metodo o una classe generano 
una o piu eccezioni e necessario consultare la 
documentazione in linea. La sintassi necessaria 
per catturare queste eccezioni e estremamente 
semplice, basta inserire il codice che si vuole 
monitorare alFinterno di un blocco di parentesi 
graffe a cui si antepone @try\ con @ catch si deli- 
mita quella parte di codice che dovra gestire in 
modo opportuno Farrivo delFeccezione, ad 
esempio deallocando una risorsa, o cercando di 
risolvere il problema; @finally invece e un blocco 
che viene sempre eseguito e che generalmente 
viene adoperato per effettuare comuni operazio- 
ni di release e pulizia delle risorse utilizzate nel 
blocco @try. Poiche il codice racchiuso da (^final- 
ly viene sempre eseguito risulta estremamente 
utile perche fornisce un unico punto in cui effet- 
tuare le tipiche operazioni di gestione delle risor- 
se, invece di doverle ripetere al termine di @try e 
di @catch. Esistono numerosi tipi di eccezioni, 
tutte istanze di NSException, che si distinguono 
per il nome (il valore del campo name, di tipo 
NSString) che queste assumono. Oltre a quelle 
predefinite, ne esistono anche altre presenti in 
alcuni precisi contesti, e che sono comunque 
descritte approfonditamente nella documenta- 
zione; incapperete alFinizio molto spesso in 
NSRangeException, quando accederete a indici 
inesistenti di strutture dati (problema che non si 
presenta analizzandole utilizzando Enumerators 
e Fast Enumerators in ambienti Thread Safe), e 
NSInvalidArgumentException, quando passerete 
parametri non validi ad un metodo. 

@try { 

//codice da monitorare 

} 

@catch (tipoeccezione *eccezione) { 
//nel caso avvenga un'eccezione di tipo 

tipoeccezione viene gestita 



} 



RIFERIMENTI WEB 

Creazione dell'account, per 
scaricare I'SDKe 
consultare la 
documentazione: 
http://developer.apple. 
com/iphone/ 



©finally { 



//questo blocco di codice viene sempre eseguito 



} 



GESTITE SITUAZIONI 
"ECCEZIOIUALI" 

Chi utilizza linguaggi di alto livello, come JAVA o 
.NET, ha utilizzato generalmente in maniera 



Nel caso di piti eccezioni si potranno inserire 
diversi blocchi @catch, in questo caso viene 
prima analizzato se Feccezione lanciata dentro 
@try e una versione realizzata ad hoc dal pro- 
grammatore, di nome CustomException e in caso 
negativo viene confrontata con NSException: 



► 56 



^PuntolnformaticD I [jjjf! 



iPhone programming 



Timer e suoni: realizziamo un progetto completo 



T iPhone programming 




@try { 



} 



@catch (Custom Exception *ce) { 



ECCEZIONE 

Con il termine "eccezione" 
si intende un 
comportamento anomalo 
del proprio applicative, 
generate da cause 
software o hardware; e 
sempre consigliato gestire 
le eccezioni per evitare un 
crash. 



} 



@catch (NSException *ne) { 



} 



©finally { 



} 



Se si volesse gestire in un unico blocco @catch 
tutte le possibili eccezioni e sufficiente cattu- 
rare quelle appartenenti alia classe 
NSException che, essendo la piu generica da 
cui derivano tutte le altre, viene sempre riscon- 
trata. Questa pratica e molto comune, ma 
spesso e piu opportuno differenziare i tipi di 
eccezioni per avere un controllo piu specifico 
di queste situazioni. Realizziamo un semplice 
blocco di codice in cui teniamo sotto controllo 
un metodo fornito dalla nostra classe che 
accetta come parametro un NSMutableArray 
che non ha alcun elemento (e infatti stato ini- 
zializzato con capacita nulla); 

NSMutableArray *anArray = nil; 

array = [[NSMutableArray alloc] 

initWithCapacity:0]; 

@try { 

[self metodo :anArray]; 

} 

@catch (NSException *exception) { 
> 

@finally { 

[anArray release]; 

} 



Nel caso in cui il metodo che abbiamo invoca- 
to lanci un qualunque tipo di eccezione siamo 
in grado di catturarlo e gestirlo come piu rite- 
niamo opportuno. Poiche quando si presenta 
un'eccezione i vari blocchi @catch vengono 
analizzati in sequenza, si procede generalmen- 
te inserendo prima quelle eccezioni apparte- 
nenti a classi piu specifiche, per poi arrivare 
alle piu generiche, dove NSException rappre- 
senta la piu generica (e anche possibile utiliz- 
zare id come tipo di eccezione piu generale ma 
non avrete probabilmente mai questa neces- 
sita): quando verra rilevata un' eccezione nel 
blocco @try sara cura deH'ambiente di esecu- 
zione verificare se il primo @catch e adatto, 
oppure se dovra procedere con il prossimo. In 
caso non ne venga trovato almeno uno, tale 
eccezione verra inviata all'istanza che contiene 
quella dove e awenuto tale evento e, in caso 
neppure questa sia in grado di gestirlo, conti- 
nued il suo tragitto fino ad un certo punto, 



identificabile con il contenitore principale 
UIApplicationMain utilizzato all'interno di 
main.m, dopo di che si verifichera un crash del 
software. Quando viene segnalato nella docu- 
mentazione in maniera esplicita che 
Tinvocazione di un metodo puo lanciare 
un'eccezione, e sempre consigliato prowedere 
a gestire tale evenienza. Nel caso non si deside- 
ri gestire un'eccezione e possibile rilanciarla, 
girarla all'oggetto che contiene l'istanza in cui 
ci troviamo, utilizzando @ throw: 

@try { 

//codice che lancia un'eccezione 



@catch(NSException *e) { 



@throw; // rilancia I'eccezione 



> 



Anche in questo caso verra utilizzata la procedu- 
ra di ricerca progressiva di @catch in grado di 
gestirla. 

L'utilizzo delle eccezioni dovrebbe essere ristret- 
to solo a questo preciso scopo: gestire comporta- 
menti anomali che richiedono un preciso inter- 
vento da parte dello sviluppatore, ma e anche 
possibile utilizzarle per rappresentare situazioni 
non anomale, come la pressione di alcune 
sequenze di tasti, che darebbero quindi inizio ad 
una precisa sequenza di eventi: tale comporta- 
mento, sebbene possibile, viene sconsigliato da 
Apple. 

NSException e corredato di un campo chiamato 
userlnfo, un NSDictionary nel quale e possibile 
inserire qualunque tipo di informazione alio 
scopo di passare alcuni dati al @catch che prov- 
vedera ad analizzarlo; tale utilizzo verra spiegato 
in un altro articolo dove mostreremo come rea- 
lizzare eccezioni customizzate. Per concludere, 
puo risultare utile mostrare a schermo (in genere 
viene utilizzato un UIAlertView) , o in un log, come 
nel prossimo esempio mostrato, la causa dell'er- 
rore e il tipo di eccezione, NSException, e conse- 
guentemente tutte le classi derivate, fornisce due 
campi stringa proprio per questo scopo, reason e 
name: 

@catch(NSException *e) { 
//gestione eccezione 
NSLog (©"EXCEPTION :%@ 

(%@)", e. reason, e. name); 



LA CLASSE NSARCHIVER 

La classe NSArchiver fornita da Cocoa e in 
grado di convertire in byte e da byte (in nume- 
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rosi linguaggi viene adoperato il termine seri- 
alizzare e deserializzare) , istanze di oggetti, 
scalari, strutture, stringhe e array, ma non con- 
sente di effettuare questa operazione per 
union, void *, puntatori a funzione e sequenze 
di puntatori. Per quanto riguarda gli NSArray e 
gli NSDictionary questi devono contenere solo 
le strutture dati supportate per essere serializ- 
zate/ deserializzare. La documentazione e suf- 
ficientemente esplicita a riguardo: 
Only instances of NSArray, NSDictionary, 
NSString, NSDate, NSNumber, and NSData 
(and some of their subclasses) can be serialized. 
The contents of array and dictionary objects 
must also contain only objects of these few 
classes. 

Per chi non fosse pratico con tali concetti, que- 
ste operazioni permettono di memorizzare lo 
stato di un'istanza su un determinato file. 
Adoperando poi la deserializzazione e possibi- 
le recuperare questo stato e riutilizzarlo per 
ripristinare Tistanza nella stessa configurazio- 
ne precedente. Utilizziamo questa classe per 
memorizzare airinterno della memoria del 
telefono la data impostata dall'utente per la 
sveglia; perche questa procedura funzioni cor- 
rettamente e necessario che la classe da cui 
deriva Tistanza su cui utilizziamo NSArchiver 
sia conforme al protocollo chiamato NSCoding 
il quale richiede che vengano implementati i 
seguenti metodi: 

• (void)encodeWithCoder:(NSCoder *)encoder (for- 
male) 

• (id)initWithCoder:(NSCoder *)decoder 

Solo encodeWithCoder viene esplicitamente 
richiesto, mentre initWithCoder, che prowede 
alia deserializzazione, e opzionale. Non 
mostreremo come realizzare il corpo di questi 
metodi perche la classe che dovremo memo- 
rizzare nel telefono, NSDate, e gia conforme a 
questo protocollo. Per capire se una classe sup- 
porta out of the box questa tecnica bastera con- 
sultare la documentazione per verificare se 
NSCoding appare tra i protocolli supportati. 
Questa procedura pub essere utilizzata per 
memorizzare informazioni arbitrarie in manie- 
ra estremamente semplice, in un videogioco o 
in un applicativo, esentando dall'obbligo di 
creare delle proprie strutture dati, come file 
xml o di testo, per organizzare tali dati. Per 
memorizzare la data che Tutente selezionera 
adoperando Y UIDatePicker bastera utilizzare il 
metodo della classe NSKEyedArchiver archive 
RootObject: toFile: che consente di effettuare la 
serializzazione immediatamente. Questo 
metodo restituisce true in caso di salvataggio 



completato, false altrimenti. 

NSString *archivePath = [[self 

applicationDocumentsDirectory] 
stringByAppendingPathComponent:@"sveglia.cfg"]; 
NSString storeResult; 

if ([NSKeyedArchiver archiveRootObject:alarmDate 

toFile:archivePath]) 

{ 

storeResult = @"Configurazione salvata con 

successo."; 

> 

else 

{ 

storeResult = @"Impossibile salvare il file!"; 




Come si pub vedere, salvare lo stato di 
un'istanza airinterno di un file locale e 
un'operazione estremamente semplice; riotte- 
nere invece la data all'awio dell' applicativo 
comporta Futilizzo di @try/@catch poiche, 
come viene esplicitato dalla documentazione: 
This method raises an NSlnvalid Argument 
Exception if the file at path does not contain a 
valid archive. E possibile evitare di utilizzare 
questa pratica verificando prima Tesistenza 
del file utilizzando il metodo fileExistsAtPath 
fornito dalla classe NSFile Manager, mostrato 
in un precedente paragrafo. 

@try 
{ 

if ((alarmDate = [NSKeyedllnarchiver 

unarchiveObjectWithFile:archivePath])){ 
[alarmDate retain]; 



} 



@catch (NSException * e) 



{ 



//Ignoriamo I'eccezione di tipo 
NSInvalidArgumentException che viene lanciata nel 
caso sveglia. cfg non venga trovato 
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CONCLUSIONI 

In questo articolo abbiamo introdotto nume- 
rosi argomenti interessanti che consentono di 
realizzare soluzioni anche molto complesse, 
giochi compresi. II progetto annesso alia rivista 
e completo e mostra come si integrano tutti 
questi concetti. Nei prossimi articoli continue- 
remo questo viaggio neiruniverso iPhone e 
Objective-C. Buona programmazione. 

Andrea Leganza 
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UN ACCELEROMETRO 
PERAMICO 

L'ACCELEROMETRO PRESENTE NELL'IPHONE E UNO DEI COMPONENTI PIU EFFICACI NEL 
CONSENTIRE ALL'UTENTE UN'INTERAZIONE CON GIOCHI E APPLICATIVI MAGGIORMENTE 
SEMPLICE E INTUITIVA. VEDIAMO COME INTEGRARLO NELLE NOSTRE APPLICAZIONI 





Conoscenze richieste 



OOP - Objectivive-C 



. MacOSX 10.5.4 o 
superiore, XCode 



Impegno 



In questo articolo andremo a realizzare un pro- 
getto minimale che ci consentira comunque di 
approfondire un argomento molto interessante: 
ricevere, analizzare, e conseguentemente utilizzare i 
dati provenienti da uno dei sensori piu utili presenti 
sia nell'iPhone che nell'iPod Touch: l'accelerometro. 
Questo piccolo componente si trova in un numero 
sempre crescente di dispositivi, merito anche del 
successo ottenuto da quando e stato inserito nel 
controller della Wii, il wiimote. Nell'iPhone questo 
componente viene principalmente adoperato per 
automatizzare la rotazione dell'interfaccia grafica 
di 90° o 180°. Con il rilascio della versione 3 del 
firmware (e del relativo SDK) e stata introdotta la 
funzionalita di shake, di scuotimento, che viene 
utilizzata per annullare Foperazione corrente, 
oppure per ripetere quella precedente, ma che si 
presta a centinaia di diverse interpretazioni, 
dipendenti solo dalla fantasia dello sviluppatore. 
Questo componente e uno di quelli che necessita 
di un dispositivo reale (non basta il simulatore 
software) per essere testato: simulare i suoi dati, 
utilizzando valori casuali o con una certa pianifi- 
cazione, non sara mai in grado di fornire un feed- 
back accurato che consenta di constatare 
l'effettiva efficacia di come si interpretano tali 
dati. L'accelerometro e un componente elettroni- 
co realizzato dalla STMicro electronics, ed e un 
modello a tre assi, simile nel funzionamento a 
quello installato nel controller della Wii, il 
Wiimote, ma in grado di rilevare teoricamente 
accelerazioni di maggiore intensita (fino a 8g); il 
sensore e in grado di funzionare in due modalita 
+/-2g e +/-8g, nel secondo caso si ha una perdita 
di precisione di circa quattro volte rispetto alle 
misurazioni ottenibili quando in modalita +/-2g, e 
per tale motivo Apple ha deciso di limitare il range 
di valori misurabili dal dispositivo per consentire 
di ottenere una maggiore accuratezza delle misu- 
razioni. E quindi possibile ottenere solo valori 
compresi tra -2g e +2g, con una precisione di circa 
0,0 18g, e purtroppo non e permesso modificare 
attraverso FAPI quale modalita il telefono deve 
utilizzare (2g o 8g). 



IIMTERFACCIA GRAFICA: 
LA ROTAZIONE 

Quando abbiamo trattato di UWiewController e 
UITable non abbiamo volutamente accennato a 
questa possibility di ruotare Finterfaccia grafica in 
base alFeffettiva posizione del telefono perche si e 
deciso di destinare tali informazioni al presente arti- 
colo. Queste rotazioni vengono gestite semplice- 
mente consultando una variabile, senza interrogare 
direttamente l'accelerometro. La visualizzazione 
"landscape", orizzontale, e estremamente utile in 
numero si contesti, non fornire ad un utente tale 
possibility pub avere un impatto negativo sull'opi- 
nione degli utilizzatori del vostro software e quindi, 
nel caso decidiate di vendere il vostro applicativo, 
potrebbe portare ad una riduzione delle vendite 
dovute a feedback non positivi. E estremamente 
semplice abilitare la propria interfaccia in modo che 
svolga tale operazione in maniera automatica, 
bastera decommentare un metodo, chiamato 
shouldAutorotateToInterface Orientation, creato 
automaticamente quando si realizza un 
UWiewcontroller, 0 una classe derivata, adoperando 
il wizard, e configurare a quali tipi di rotazioni tale 
controller dovra reagire: 

// Override to allow orientations other than the 

default portrait orientation. 
- (BOOL)shouldAutorotateToInterfaceOrientation : 

(UllnterfaceOrientation)interfaceOrientation { 
// Return YES for supported orientations 
return (interfaceOrientation = = 

UllnterfaceOrientationPortrait); 

y~ 

Dopo aver decommentato il metodo analizziamo 
sia il parametro che riceve che il suo codice interno: 
interfaceOrientation e di tipo Ullnterface 
Orientation, una enum in linguaggio C, i cui possibi- 
li valori sono i seguenti: 

typedef enum { 

UIDeviceOrientationUnknown, 



UIDeviceOrientationPortrait, 



// Device 
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oriented vertically, home button on the bottom 
UIDeviceOrientationPortraitUpsideDown, // Device 

oriented vertically, home button on the top 
UIDeviceOrientationLandscapeLeft, // Device 

oriented horizontally, home button on the right 
UIDeviceOrientationLandscapeRight, // Device 

oriented horizontally, home button on the left 
UIDeviceOrientationFaceUp, // Device 

oriented flat, face up 
UIDeviceOrientationFaceDown // Device 

oriented flat, face down 

} UIDeviceOrientation; 

Quando otteniamo un orientamento di tipo portrait 
significa che il telefono e tenuto in posizione verti- 
cals sia quando il pulsante home del telefono punta 
verso il basso, che quando il telefono e capovolto e 
tale pulsante punta verso l'alto {UpsideDown); land- 
scape owiamente indica che il telefono e tenuto 
orizzontalmente, con il pulsante home posizionato 
sul lato sinistro [LandscapeRight], o sul lato destro 




Fig. 3: La rotazione viene effettuata automaticamente 



(LandscapeLeft); FaceUp e Down vengono utilizzati 
per notificare che il telefono ha lo schermo verso 
posizionato in basso, verso il pavimento, o verso 
l'alto. Queste modalita consentono di far reagire la 
propria interfaccia in base a 6 disposizioni predefi- 
nite del telefono, senza necessariamente analizzare i 
dati che provengono dal telefono e questa modalita 
di consultazione e la piu indicata per modificare la 
grafica del proprio software. II metodo viene interro- 
gato dal sistema operativo del telefono che fornira 
tale parametro e attendera un valore booleano che 
gli consentira di decidere se ruotare o meno 
Finterfaccia automaticamente. La scelta se ruotare o 
meno dipende da un semplice confronto tra il valo- 
re passato come parametro al metodo e i possibili 
stati del telefono. Decommentando questo metodo 
non si imposta ancora alcuna rotazione: per tale 
motivo, se volessimo far ruotare la nostra interfaccia 
grafica di 90 o 180 gradi, dovremo aggiungere, oltre a 
UllnterfaceOrientationPortrait, anche le altre moda- 
lita che vogliamo facciano scattare il meccanismo di 
rotazione. Cio si effettua separando le modalita sup- 
portare utilizzato OR (simbolo ||): 

- (BOOL)shouldAutorotateToInterfaceOrientation : 



(UllnterfaceOrientation)interfaceOrientation 



{ 


// Return YES for supported orientations 




return (interfaceOrientation = = 




UllnterfaceOrientationPortrait 1 1 




UIInterfaceOrientationLandscapeLeft 1 1 




UIInterfaceOrientationLandscapeRight); 


} 



In questo modo abbiamo automatizzato la rotazio- 
ne sia quando il software e verticale e quando e 
orizzontale in entrambi i versi. 
Questo tipo di gestione delFaccelerometro e Tunica 
che e possibile testare parzialmente anche con il 
solo simulatore: bastera, tenendo premuto il tasto 
mela, operare sui i tasti cursore per far ruotare di 
90° a sinistra e a destra Finterfaccia, e verificare 
conseguentemente come reagisce il software. 
Purtroppo le modalita portraitupsidedown e face- 
up/down non sono disponibili. La rotazione auto- 
matica si propaga anche ai componenti contenuti 
alFinterno del ViewContr oiler, UlView, immagini e 
tutti gli altri inseriti dallo sviluppatore, ma non ha 
sempre Fesito sperato, cio e dovuto al fatto che in 
alcune situazioni e necessario adoperare altri stru- 
menti di modifica delle coordinate, che risultano 
piu adatti (le cosiddette Core Animation 
Transformations, di cui parleremo in un altro arti- 
colo). Prendiamo come esempio un'immagine 
posizionata nel centro della nostra interfaccia. 
Quando andremo a ruotare Finterfaccia otterremo 
un effetto simile a quello visibile in Fig. 5. 
La palla da rugby si e posizionata in maniera non 
corretta, un risultato alquanto indesiderato, vedre- 
mo in un prossimo articolo come effettuare delle 
trasformazioni sulle coordinate (le cosiddette tra- 
sformazioni affini) degli oggetti presenti nelFinter- 
faccia che permetteranno di ottenere il risultato 
desiderato. 



I MOTION EVENTS 

L'SDK 3.0 ha introdotto il concetto di motion 
events, eventi generati dal movimento. Questi sono 
scatenati dopo alcune situazioni identificate dal- 
Faccelerometro, e non richiedono quindi misura- 
zioni continue da parte delFutente. Gli eventi 
disponibili sono in numero limitato: 

• motionBegan 

• motionEnded 

• motionCancelled 

Tutti i tre eventi ricevono due parametri: il primo, 
di tipo UIEventSubtype, consente di identificare se 
il movimento e stato identificato come apparte- 
nente ad una certa tipologia. Al momento Funico 




-¥ 

Fig. 1: La disposizione 
degli assi e dei versi posi- 
tivi e negativi dell'accele- 
rometro 




Fig. 2: La comune visua- 
lizzazione verticale di una 
tabella 
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Fig. 4: II pallone da rugby 
e al centro dell' inter fac- 
cia 



SPECIFICHE 
HARDWARE 

A questi indirizzi e possibile 
consultare la 
documentazione dei due 
modelli di sensori utilizzati 
nelle diverse versioni 
dell'iPhone e dell'iPod 
Touch: 
LIS302DL: 
http://www.st.com/ston I i n 
e/products/literature/ds/1 2 
726/lis302dl.pdf 
LIS331DL: 
http://www.st.com/ston I i n 
e/products/literature/ds/1 3 
951.pdf 



effettivamente utile e UIEventSubtypeMotionShake 
{UIEventSubtypeNone non fornisce alcuna infor- 
mazione utile) il quale consente di identificare se 
Futente ha agitato il telefono: se si volesse suppor- 
tare la possibility di annullare un'operazione di 
scrittura di una email ad esempio agitando il dispo- 
sitivo, basterebbe verificare se la variabile motion 
assume valore pari a questo tipo di movimento con 
un semplice ife in caso affermativo agire di conse- 
guenza (cancellando il testo, magari richiedendo 
con un UIAlertla conferma di tale operazione). 
E possibile emulare lo shake tramite il simulatore 
adoperando la voce omonima presente nel menu 
hardware. 

- (void)motionBegan:(UIEventSubtype)motion 

withEvent:(UIEvent *)event 

{ //gestione evento} 

- (void)motionEnded : (UIEventSubtype)motion 

withEvent:(UIEvent *)event 

{//gestione evento } 

- (void)motionCancelled : (UIEventSubtype)motion 

withEvent:(UIEvent *)event 



{ //gestione evento 



if (event. type == UIEventSubtypeMotionShake) { 
//se il movimento e di shake agiamo di conseguenza 



} 



} 



II parametro event non ha alcuna utilita in questo 
contesto, viene utilizzato per altri tipi di eventi, 
quelli touch (il tocco dello schermo) e fornisce 
informazioni sulle coordinate dei dei vari punti in 
cui e awenuta Finterazione delFutente. L'utilizzo di 
motionBegan e motionEnded e immediato, mentre 
Futilita di motionCancelled e meno intuitiva: que- 
sto metodo assume importanza quando un evento 
identificato come uno di tipo shake dura troppo 
tempo (oltre un secondo) oppure quando il fra- 
mework Cocoa Touch richiede Finterruzione dell'a- 
nalisi del movimento, in entrambi i casi questo 
blocco di codice dovrebbe contenere il codice per 




Fig. 5: La rotazione automatica si e rivelata scarsamente 
efficace, generando un risultato indesiderato nella mag- 
gior parte dei casi 



ripristinare lo stato del software prima delle modi- 
fiche effettuate alFinterno di motionBegan. 
Nel caso in cui il movimento non venga gestito in 
nessun UlViewController, e la proprieta applica- 
tion SupportsShakeToEdit del nostro applicativo sia 
impostata a YES (accessibile tramite il singleton 
UIApplication di cui parleremo in un prossimo 
articolo) verra presentato un menu di scelta tra 
undo (annullamento) o redo (ripetizione). Questi 
tre metodi sono meno utili rispetto alia consulta- 
zione dei dati forniti dalFaccelerometro ma nel 
caso delFidentificazione del movimento di shake 
forniscono il modo piu semplice e veloce per sup- 
portare questo tipo di interazione. 



IL PRELIEVO DELLE 
INFORMAZIONI 

Ora che abbiamo mostrato due situazioni in cui fare 
uso in maniera implicita delle informazioni prove- 
nienti dalFaccelerometro, realizziamo il codice 
necessario per abilitare e leggere i suoi dati in modo 
esplicito. Ogni applicativo pub accedere a una sola 
istanza della variabile che fornisce i dati dell'accele- 
rometro, un singleton secondo la terminologia 
object oriented, tale istanza appartiene al tipo di 
dato UIAccelerometer; per abilitare la ricezione dei 
dati si prowede a impostare se stessi, la classe in cui 
si analizzano i dati, come delegate dell'accelerome- 
tro, mentre per disabilitare la ricezione e sufficiente 
reimpostare a nil tale delegate. 

int frequency = 50; 

U I Acce I e ro m ete r * my Acce I e ro m ete r ; 

-(IBAction)configurazioneAccelerometro 
{ 

myAccelerometer = [UIAccelerometer 

sharedAccelerometer] ; 
myAccelerometer.updatelnterval = 1 / frequency; 
//Impostiamo il delegate 
myAccelerometer.delegate = self; 
//Da questo momento verranno inviati i dati 

daN'accelerometro tramite I'invocazione del metodo 
accelerometer: didAccelerate 



Impostando la classe in cui si trova come delegate si 
dichiara di rispettare il protocollo chiamato 
UIAccelerometerDelegate, come suggerito in articoli 
precedenti e sempre consigliato dichiarare tale ope- 
razione nel file di interfaccia .h: 

©interface accelerometroViewController : 

UlViewController < UIAccelerometerDelegate> 

La variabile myAccelerometer viene creata richie- 
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dendo al singleton UIAccelerometer la sua istanza, 
tramite il metodo sharedAcelerometer. E possibile 
poi prelevare dati a diverse frequenze, in questo caso 
abbiamo scelto 50Hertz, cio significa il prelievo di 
una misurazione del sensore ogni 20 millisecondi. 
Per chi non avesse conoscenza di queste definizioni 
lHerz indica una misurazione ogni secondo, 2 Herz 
2 al secondo, 10 Hertz 10 al secondo e cosi via. 
II range di valori consentiti e consigliati da Apple 
sono: 

• 10-20 Herz: per misurare il verso del telefono 

• 30-60 Herz: per giochi e applicativi in cui e richie- 
sta maggiore precisione 

• 70-100 Herz: per misurazione con variazioni di 
posizione molto elevata 

I valori verso i 100 Herz non vengono quasi mai uti- 
lizzati perche raramente e necessaria una tale preci- 
sione. L'asse z assumera un valore prossimo a +1 
quando il telefono sara appoggiato su una superficie 
piana, parallela al pavimento, -1 quando lo schermo 
tocchera il piano; y assumera valore -1 quando il 
telefono sara in posizione portrait con il pulsante 
home in basso, +1 quando il pulsante home sara 
rivolto verso Talto; x varra -1 quando lo schermo 
sara rivolto verso sinistra e +1 verso destra. Tutti i 
valori compresi tra + e -1 per tutti gli assi verranno 
assunti quando non si posiziona il telefono perfetta- 
mente perpendicolare al piano. La somma delle tre 
misurazioni deve valere in valore assoluto circa 1. 
Dopo aver configurato la modalita di ricezione dei 
dati, notifichiamo alia variabile che siamo in grado 
di ricevere e gestire le sue informazioni, per tale 
motivo la informiamo che siamo un delegate; a que- 
sto punto e necessario implementare il metodo che 
raccelerometro invochera ad ogni aggiornamento: 

- (void)accelerometer: (UIAccelerometer 

*)accelerometer didAccelerate:(UIAcceleration 
*)acceleration 



{ 



Avevamo detto che i dati provenienti dall'accelero- 
metro erano di tipo double, ma in questo caso 
abbiamo adoperato UIAccelerationValue, ebbene 
questo tipo di dato e intercambiabile con double, 
essendo un suo alias: 

typedef double UIAccelerationValue; 

Per finire, creiamo un metodo che verra invocato 
quando si desidera che termini il rilevamento: 

-(void) terminaAnalisi { 

myAccelerometer.delegate = nil; } 



Nel caso si desideri gestire alFinterno di un solo 
UWiewController queste misurazioni e obbligato- 
rio fare in modo che il delegate sia impostato a nil 
prima che il viewcontroller venga rimosso dallo 
stack di controller. Se ci troviamo in un sistema di 
navigazione tra controller, poiche altrimenti si 
rischia il verificarsi di crash casuali dovuti all'invo- 
cazione del metodo accelerometer: didAccelerate 
su un'istanza non piu esistente (con il verificarsi 
della chiamata ad uno zombie quindi). Per visua- 
lizzare immediatamente i dati provenienti dalla 
misurazioni dei tre assi bastera creare tre UILabel, 
impostarle come IBOutlet, e modificare il testo 
contenuto in base alle rilevazioni: 

- (void)accelerometer: (UIAccelerometer 

*)accelerometer didAccelerate : (UIAcceleration 

*)acceleration 

{ 

UIAccelerationValue x, y, z; 
x = acceleration. x; 
y = acceleration. y; 
z = acceleration. z; 



//Aggiornamento del testo dei tre UILabel 
xLabel.text = [NSString 

stringWithFormat:@"%g",x]; 
yLabel.text = [NSString 

string With Format :(gy ,0 / 0 g M ,y]; 
zLabel.text = [NSString 

stringWithFormat:@"%g",z]; 



UNA Wll COME TESTER 

Anche se all'inizio dell'articolo abbiamo dichia- 
rato che non e possibile simulare senza il dispo- 
sitivo reale i dati deH'accelerometro, in realta 
esistono alcune soluzioni che consentono di 
bypassare questa richiesta, una di queste consi- 
ste nell'adoperare un controller della Wii, colle- 
garlo via Bluetooth e fornire tali informazioni 
attraverso un web server, che verra consultato 
da codice appositamente realizzato nel proprio 
applicativo sull'iPhone. Questa soluzione com- 
porta sia la realizzazione del codice client nel 
telefono che di quello server al quale fa riferi- 
mento il dispositivo e non e quindi 
un'operazione che un utente non pratico con un 
altro linguaggio di programmazione (ad esem- 
pio C#) potrebbe realizzare in maniera autono- 
ma in tempi relativamente brevi. Inoltre si deve 
tener conto che il sensore del wiimote invia dati 
fino a 3g, mentre, come abbiamo precisato in 
precedenza, nell'iPhone si arriva fino a 2g. 

Andrea Leganza 




RIFERIMENTI WEB 

Creazione dell'account, per 
scaricare I'SDK e 
consultare la 
documentazione: 
http://developer.apple. 
com/iphone/ 
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IPHONE: GESTIRE 
IL MULTI-TOUCH 

LO SCHERMO MULTITOUCH CONSENTE Dl INTERAGIRE CON UN DISPOSITIVO SENZA LA 
NECESSITA Dl FORNIRE INGOMBRANTI TASTIERE. IMPARIAMO A INTERCETTARE LE AZIONI 
DEGLI UTENTI E A GESTIRLE IN MODO DA NON FAR RIMPIANGERE TASTIERA E MOUSE 



LJ evoluzione tecnologica e la conseguente discesa 
dei prezzi hanno consentito ai produttori di 
I dispositivi mobili di inserire nei propri prodotti 
uno o piu schermi touch screen: quello che prima era un 
componente riservato a contesti specializzati, e divenu- 
to sempre piu frequente nell'elettronica di largo consu- 
mo. Nell'interfaccia dell'iPhone il multitouch consente 
di interagire in molti modi con i componenti grafici: 

• tocco singolo (single tap) 

• tocchi multipli (multi tap) 

• trascinamento (drag) 

• scrolling verticale (swipe verticale) 

• strisciata (swipe orizzontale) 

II termine Swipe, utilizzato nella documentazione 
iPhone, e sinonimo del piu comune "scrolling", ed e 
quindi quell' operazione adoperata generalmente 
per passare da un contenuto all'altro, immagini o 
video ad esempio, e che consiste in un repentino 
movimento di uno o piu dita da destra a sinistra o 
viceversa; In questo articolo vedremo di accedere 
ai dati che questo dispositivo e in grado di fornire 
alio sviluppatore, e li utilizzeremo per i nostri scopi. 



COME FUniZIOIMA 
UN TOUCH SCREEN 

II multi-touch presente nell'iPhone e un insieme di 
strati costituiti da diversi materiali e in alcuni livel- 
li e percorso da componenti elettrici che, quando 
vengono a contatto con gli strati superiori, identifi- 
cano tale situazione come la pressione da parte 
dell'utente di una precisa area dello schermo. Gli 
strati necessari per il funzionamento del multitou- 
ch sono interposti tra una copertura antiriflesso, 
quella che effettivamente Futente tocca con le pro- 
prie dita, e il display LCD vero e proprio. Cosa suc- 
cede quando un utente tocca lo schermo? I vari 
strati superficiali collidono nei punti in cui awen- 
gono le pressioni, questi eventi generano dei 
segnali elettrici abbastanza imprecisi a causa di 



normali interferenze elettriche, che rappresentano 
aree di schermo di circa 1 cm di lato (tale e la 
dimensione delFarea che andiamo a toccare effet- 
tivamente), su queste informazioni vengono effet- 
tuate delle stime per identificare al meglio la regio- 
ne dove effettivamente Futente voleva interagire, 
infine vengono calcolate le coordinate del centro di 
queste aree e vengono inviate, se richiesto, al vostro 
software, altrimenti vengono ignorate. 



UIEVEIMT E UITOUCH 

Ogni componente pub rispondere alle interazioni 
dell'utente, purche discenda dalla classe 
UIResponder, UlViewController, UlView, e conse- 
guentemente le loro classi figlie (in pratica tutti i 
componenti grafici), derivano da tale padre, e per 
tale motivo sono pienamente autorizzate a gestire 
tali eventi. Owiamente, poiche un 
UlViewController contiene al suo interno un 
UlView, potra intercettare il tocco prima delle view 
e gestirlo senza demandare tale operazione ad una 
delle sue view 

I seguenti quattro metodi: 

- (void)touchesBegan:(NSSet *)touches 

withEvent:(UIEvent *)event; 

- (void)touchesMoved:(NSSet *)touches 

withEvent:(UIEvent *)event; 

- (void)touchesEnded:(NSSet *)touches 

withEvent:(UIEvent *)event; 

- (void)touchesCancelled:(NSSet *)touches 

withEvent:(UIEvent *)event 

sono quelli, forniti dalla classe UIResponder, che ci 
consentono di intercettare i tocchi effettuati dall'u- 
tente: non e necessario alcuna operazione aggiun- 
tiva, (come impostare protocolli o delegate per ini- 
ziare a gestirli). L' ultimo metodo e meno intuitivo, 
viene invocato dal sistema quando si scatenano 
eventi fuori dal controllo dell'utente, come una 





Fig. 1: Una semplice 
interfaccia grafica per 
realizzare un sistema di 
drag and drop 
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TOUCH -SCREEN 

Per una descrizione piu 
approfondita del 
funzionamento del touch- 
screen dell'iPhone: 
http://electronics.howstuff 
works.com/iphone1 .htm 



RIFERIMENTI WEB 

Creazione dell'account, per 
scaricare I'SDKe 
consultare la 
documentazione: 
http://developer.apple.co 
m/iphone/ 



possibile chiamata, una rimozione della view su 
cui si sta analizzando il tocco (ad esempio per un 
retain che ne invoca il distruttore), o altra notifica 
come quello di batteria in esaurimento, che annul- 
lano il completamento delle operazioni di tocco 
iniziate dalFutente, in questo metodo generalmen- 
te si ripristina il sistema alio stato interno prece- 
dente, corrispondente a quello trovato quando e 
stato invocato per la prima volta il metodo 
touchesBegan. II primo parametro di questi metodi, 
NSSet, e un'istanza di una classe il cui scopo e quel- 
lo di raccogliere in se piu oggetti in maniera non 
ordinata. In questo caso al suo interno troviamo 
tutte istanze della classe UITouch, ognuna a rap- 
presentare le diverse dita che toccano lo schermo. 
La classe UITouch fornisce informazioni riguardo 
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Fig. 2: II contenuto di una istanza di tipo UlEvent 



la posizione attuale del tocco (un punto di tipo 
CGPoint e coordinate [x,y] ottenuto con la chiama- 
ta al metodo (locationlnView:) , quella precedente 
(previousLocationlnView:) , il numero di pressioni 
ripetute (proprieta tap) del dito sullo schermo ed 
effettuate in breve sequenza (proprieta tapCotunt), 
la view in cui questo e stato identificato (proprieta 
view), Fistante temporale in cui tali coordinate 
sono cambiate (proprieta timestamp, utile per 
misurare la durata di un movimento, ad esempio), 
e la fase del tocco (proprieta phase), informazione 
che consente di identificare lo stato del tocco: 

UITo uchPhaseBegan, 
UITo uchPhaseMoved, 
UITo uchPhaseStationary, 
UITo uchPhaseEnded, 
UITo uchPhaseCancelled, 

Quando ci troviamo in un progetto in cui non ci 
interessa se uno o piu dita toccano lo schermo, ma 
vogliamo sapere la posizione di uno qualsiasi dei 
tocchi, bastera invocare il seguente metodo, reso 
disponibile dalla classe NSSet, alFinterno di uno 
dei metodi touches*: 

UITouch *touch = [touches anyObject]; 

il quale restituisce un'istanza in modo pseudo- 
casuale (non e detto che sia sempre diversa per 
ogni invocazione successiva); owiamente se esiste 
un solo tocco anyObject restituira sempre questo. 
NelFarticolo precedente avevamo parlato di come 



gestire i dati che provenivano dal sensore, 
Faccelerometro, presente nel dispositivo, e aveva- 
mo trattato della famiglia di eventi definiti con la 
struct UIEventType che raccoglie al suo interno sia 
gli input di movimento (misurati dalFaccelerome- 
tro) che quelli di tocco: 

typedef enum { 

UIEventTypeTouches, 

UIEventTypeMotion, 
} UIEventType; 

II secondo parametro di tutti i metodi touches* e di 
tipo UlEvent e assumera come tipo owiamente il 
valore UIEventTypeTouches. L'istanza appartenente 
alia classe UlEvent rappresenta quindi lo stato 
attuale delle dita che sono a contatto con lo scher- 
mo, e consente di identificare univocamente le sin- 
gole istanze di UITouch e come e variato il loro 
stato. Per ottenere i tocchi relativi ad una determi- 
nata view basta invocare alFinterno di uno dei 
metodi touches* su tale UlEvent il metodo 
touchesForView: 

Come riesce il dispositivo a identificare in quale 
UlView viene effettivamente effettuato il tocco con 
una certa coordinata? Questa ricerca awiene sem- 
plicemente effettuata in maniera iterativa: si parte 
dal contenitore principale, che racchiude in se tutti 
gli oggetti visuali del nostro applicativo, la 
UlWindow, e si procede "scendendo" tra gli 
UlViewController e le rispettive UlView effettuando 
su di queste il metodo pointlnsideiwithEvent. Tale 
procedura prosegue per ogni UlView che restitui- 
sce YES a tale chiamata, fino a raggiungere Fultima 
UlView che diventera la responsabile della gestione 
e delFinterpretazione del tocco: tale sequenza di 
view e viewcontrollers prende il nome di "respon- 
der chain", catena di risposta. Nel caso Fultima 
view non fosse configurata per gestire il tocco il 
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Fig. 3: La responder chain dell'iPhone 
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metodo di ricerca risalira tra le UlView (e i rispettvi 
controllers) che la contengono in cerca di una in 
grado di "reagire" a tale operazione; nel caso peg- 
giore, quello in cui si ritrovasse di nuovo 
nelF UlWindow, tale evento verra ignorato. 



ABILITARE 

E DISABILITARE 

L'lniTERAZIORIE 

Nel caso in cui non si desideri che una view riceva 
uno o piu eventi dovuti al tocco da parte delFuten- 
te e possibile disabilitare tale interazione in diversi 
modi attraverso Futilizzo di proprieta o metodi for- 
niti dalla classe UlView: 

• Configurandola come trasparente (ex: 
myUIView. alpha-0. 0) ; 

• Configurandola come nascosta (ex: 
myUIView. hidden-YES) ; 

• Impostando la sua proprieta userlnteraction 
Enabled a NO: (ex: myUIView. userlnteraction 
Enabled=NO); 

Nel caso si decidesse di disabilitare completamen- 
te F interazione per Fintero applicativo, ad esempio 
quando si effettuano delle animazioni sarebbe suf- 
ficiente invocare prima di tale situazione 
beginlgnoringlnteractionEvents e successivamente 
endlgnoringlnteractionEvents sul singleton 
UIApplication (e un'istanza di una classe unica 
durante tutta la vita delF applicativo) nel seguente 
modo: 

[[UIApplication sharedApplication] 

beginlgnoringlnteractionEvents]; 
//Eventi che non richiedono interazione con I'utente 
[[UIApplication sharedApplication] 

endlgnoringlnteractionEvents]; 

Per default i tocchi multipli non vengono gestiti 
automaticamente, sono percio ignorati e vengono 
passate all' applicativo solo quelle informazioni 
relative al primo tocco rilevato; per abilitare il mul- 
titouch e necessario invocare nel proprio codice, 
quando necessario, il metodo multipleTouch- 
Enabled sulla UlView che dovra gestirli. Se si desi- 
dera fare in modo che solo una UlView risponda a 
tutti gli eventi si dovra impostare la sua proprieta a 
exclusiveTouch a YES. 



LE SEQUENZE DI TAP 

Multitouch non signilica solo gestire i tocchi delle 
dita contemporaneamente senza identificare la 
sequenza con cui questi sono awenuti, nelFiPhone 



OS e presente una logica in grado di monitorare e 
analizzare diversi tipi di interazioni, sia in base al 
numero che alia direzione del movimento effettua- 
to dalle dita che in quel preciso momento sono a 
contatto con lo schermo. 

La sequenza tipo di un evento di tipo singolo tocco 
e costituito dai seguenti passi: 

1- un dito tocca lo schermo; 

2- il dito viene mosso mantenendolo a contatto 
con lo schermo (opzionale) 

3- il dito viene rimosso 

Se il movimento, (il secondo passo descritto nella 
lista), e un'operazione opzionale, la prima e la 
seconda awengono obbligatoriamente in un inter- 
vallo di tempo che pub essere piu o meno breve, 
nel caso in cui si effettui la tipica operazione di tap, 
termine che sta ad indicare la pressione singola o 
piu volte delle dita, siamo in grado in maniera sem- 
plice di ottenere il numero di questi tocchi senza 
necessariamente dover utilizzare una variabile per 
contabilizzarli. 

La sequenza tipo di un evento multi tocco e costi- 
tuito dai seguenti passi: 
1 - un primo dito tocca lo schermo; 
2- un secondo dito tocca lo schermo (il numero 
delle dita pub essere superiore a due); 

3 - uno o entrambi effettuano un movimento; 

4 - in successione vengono rimossi entrambi 
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Fig. 5: Una tipica situazione di sequenza di eventi 



SINGLE-TAP 
E MULTI-TAP 

Come e stato detto precedentemente e possibile 
conoscere con estrema facilita il numero di tocchi 
effettuati in un breve intervallo di tempo dalFuten- 
te, basta consultare la proprieta tapCount, in gene- 
re cib viene fatto alFinterno del metodo 
touchesEnded (quando uno o piu dita vengono 
rimosse quindi). 

- (void)touchesEnded:(NSSet *)touches 

withEvent:(UIEvent *)event { 
for (UITouch *touch in touches) { 
if (touch. tapCount == 1) { 
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Fig. 4: 1 due checkbox 
posizionati in basso con- 
sentono di cambiare il 
comportamento predefini- 
to delta view attraverso 
Interface Builder 
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//do something } 



struct CGPoint { 



else if (touch. tapCount == 2) { 



CGFIoat x; 



Fig. 6: Una tipica situazio- 
ne di sequenza multipla 
di eventi 



//do something } 



else if (touch. tapCount == 3) { 



//do something} 



//etc tapCount>3 



} 



IDEIMTIFICHIAMO E 
GESTIAMO LO "SWIPE" 

Abbiamo detto che con il termine swipe si identifi- 
ca lo scorrimento orizzontale/verticale di uno, o 
piu dita. Per supportarlo alFinterno delle proprie 
UlView (o UlViewController) e necessario effettua- 
re alcuni calcoli che identifichino se lo spostamen- 
to delle dita e dovuto ad un movimento volontario 
oppure ad un semplice tremolio del dispositivo in 
mano all'utente; per fare cio si deve misurare in un 
intervallo di tempo come variano le coordinate del 
tocco e, nel caso tale delta sia superiore o uguale ad 
un valore predefinito, si pub ritenere con una rela- 
tiva certezza che Futente stia effettivamente effet- 
tuando tale operazione. Vista Finaccuratezza del 
movimento delle dita in una delle due direzioni, e 
opportuno considerare come swipe qualunque 
movimento che comporti uno spostamento alFin- 
terno di un ipotetico rettangolo , il cui centro geo- 
metrico e dato dalla coordinata del primo tocco. 
Studiamo il caso di swipe orizzontale. 
Se il movimento verticale (sia verso Falto che il 
basso) superera una costante predefinita, MASSI- 
MODELTAVERTICALE, il cui valore e espresso in 
pixel, non identifichiamo tale movimento come 
uno swipe. In tale situazione e probabile che 
Futente voglia effettuare o uno scrolling in direzio- 
ne obliqua oppure in orizzontale, ma per qualche 
motivo non e riuscito ad effettuarlo in maniera cor- 
retta. Di conseguenze se il movimento orizzontale 
non sara maggiore di un certo numero di pixels, 
espresso dalla variabile MINIMODELTAORIZZON- 
TALE, allora e probabile che il movimento identifi- 
cato non sia volontario e lo ignoreremo. Variando 
tali estremi potremo decidere in che modo reagire 
ai diversi movimenti , forzando Futente ad effettua- 
re gesti molto precisi oppure consentendogli una 
maggiore liberta. 

#define MINIMODELTAORIZZONTALE 8 //minimo 

spostamento orizzontale in pixel 
#define MASSIMODELTAVERTICALE 6 //massimo 

spostamento verticale in pixel 

Iniziamo memorizzando la posizione del primo 
tocco nella variabile chiamata startTouchPosition: 
e di tipo CGPoint, una semplice struttura C 



CGFIoat y; 



}; 



typedef struct CGPoint CGPoint; 

I valori che CGPoint potra rappresentare quando 
toccheremo lo schermo con un dito potranno 
appartenere a qualunque punto di coordinate (x,y), 
dove x e compreso tra 0 e 320 e y tra 0 e 480 (0,0 
bordo alto a sinistra del telefono, 320,480 basso a 
destra), dovute alia risoluzione delFLCD 
delFiPhone {CGPoint pub assumere comunque 
valori superiori o inferiori a questi intervalli ma 
owiamente rappresentano posizioni esterne 
alFLCD e non visibili all'utente). 
Per determinare se il movimento e contenuto 
alFinterno delFarea utile, effettuiamo semplice- 
mente il calcolo della differenza tra la coordinata 
precedente, misurata alFinterno del metodo 
touchesBegan, e quella rilevata successivamente 
alFinterno di touchedMoved: in valore assoluto, 
adoperando la funzione Cfabsfi 

CGPoint startTouchPosition; 

- (void)touchesBegan:(NSSet *)touches 

withEvent:(UIEvent *)event 

{ 

UITouch *touch = [touches anyObject]; 
startTouchPosition = [touch locationInView:self]; 

> 

- (void)touchesMoved:(NSSet *)touches 

withEvent:(UIEvent *)event { 
UITouch *touch = [touches anyObject]; 
CGPoint currentTouchPosition = [touch 

locationInView:self]; 

if (fabsf(startTouchPosition.x - 

currentTouchPosition. x) > = 
MINIMODELTAORIZZONTALE && 
fabsf(startTouchPosition.y - currentTouchPosition. y) 

<= MASSIMODELTAVERTICALE) { 

if (startTouchPosition. x < 

currentTouchPosition. x) { 

//swipe a destra 

} 

else {//swipe a sinistra} 

» 

- (void)touchesEnded:(NSSet *)touches 

withEvent:(UIEvent *)event { 
//azzeriamo la posizione iniziale 
startTouchPosition = 0.0;} 

- (void)touchesCancelled:(NSSet *)touches 

withEvent:(UIEvent *)event { 
//azzeriamo la posizione iniziale se e avvenuto un 

evento che ha annullato I'operazione 
startTouchPosition = 0.0;} 



Quando verra alzato il dito, sara sufficiente azzera- 
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re la posizione iniziale per essere di nuovo pronti a 
studiare i tocchi successivi. E possibile quindi, 
variando i due valori di delta predefiniti, creare aree 
verticali per supportare lo scrolling verticale, come 
awiene ad esempio per le UITableView o le 
UlScrollView. 



GESTIRE 

IL TRASCINAMENTO 

L'operazione di drag&drop, si rivela meno compli- 
cata rispetto a quella di swipe: bastera infatti iden- 
tificare quale UWiew e stata toccata e muoverla di 
conseguenza, in risposta agli spostamenti del dito. 
Esistono due metodi principale per gestire tale 
operazione: 

gestire tale comportamento alFinterno del 
UlViewController, che prowedera a spostare la 
UWiew 

gestire tale comportamento alFinterno della 
UWiew stessa, creando una classe figlia di UWiew. 

Nel nostro progetto abbiamo deciso di gestire 
Finterazione alFinterno del viewcontroller: il pregio 
di questo approccio e dovuto alia possibility di 
identificare possibili sovrapposizioni tra le view e 
agire di conseguenza (ad esempio realizzando un 
semplice algoritmo di analisi delle collisioni come 
viene fatto per i giochi) e quindi dovremo inserire i 
vari metodi touches* nel suo file di implementazio- 
ne (.m). Creiamo quindi il nostro progetto, di tipo 
View-Based Application. Creiamo due IBOutlet 
(ricordate di chiamare su entrambi il metodo 
release nel metodo dealloc alio scopo di evitare 
leaks), di nome red e green in questo esempio, 
alFinterno del file di interfaccia (.h) della classe 
chiamata progettoViewController: 

©interface progettoViewController : UlViewController 

{ 

IBOutlet UlView *red; 

IBOutlet UlView *green; 

} 

@end 




Fig. 8: L'operazione di associazione tra IBOutlet e 
UlView 



Apriamo con interface builder il file chiamato 
nomeprogettoviewcontroller.xib e trasciniamo 
alFinterno della view principale due ulteriori 
UWiew, ridimensioniamole a nostro piacimento, e 
impostiamone i colori in modo da poterle distin- 
guere visivamente. Premiamo il tasto destro del 
mouse sulla voce Files Owner e, tramite la solita 
operazione di trascinamento dei due IBOutlet, col- 
leghiamoli con le due UWiew appena create. 
Ora non ci resta che implementare i soliti metodi 
per gestire l'operazione di trascinamento; per sem- 
plicita realizziamo solo il codice relativo alFevento 
di movimento che invoca di conseguenza il meto- 
do touchesMoved: withEvent, gli altri in questo caso 
non sono necessari. 

- (void)touchesMoved:(NSSet *)touches 

withEvent: (UIEvent *)event 

{ 

UITouch *theTouch = [touches anyObject]; 

CGPoint newPosition = [theTouch 

locationInView:self.view]; 

if ([self.view hitTest: newPosition withEvent:event] 

== red){ 

red. center = newPosition; 

} 

else if ([self.view hitTest: newPosition 

withEvent:event] == green){ 
green. center = newPosition; 

} 



} 



II funzionamento e abbastanza intuitivo: prima 
otteniamo la posizione del tocco, rappresentata dal 
solito CGPoint, successivamente dobbiamo deci- 
dere se questo punto e occupato da uno dei nostri 
due UWiew: Per effettuare tale operazione interro- 
ghiamo la view principale, self.view, quella che 
contiene le due UWiew figlie, invocando su di que- 
sta il metodo hitTest; hitTest e un metodo che resti- 
tuisce come risultato quale UWiew si trova in un 
determinato punto: bastera quindi verificare che 
questa corrisponda alia view chiamata red o green, 
per decidere su quale stia awenendo il tocco. Per 
spostare la view selezionata bastera cambiarne il 
centro, utilizzando la proprieta center (sempre di 
tipo CGPoint), attribuendole valore pari alia posi- 
zione del tocco. Una soluzione alternativa al codice 
proposto per venire a conoscenza di quale view e al 
momento toccata consiste nelFutilizzare il metodo 
touchesForView: fornito da UIEvent. Abbiamo cosi 
mostrato i vari modi di interpretare Finterazione 
delFutente in base al numero ed al tipo di touch. 

Andrea Leganza 
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Fig. 7: II sistema di coor- 
dinate dell'iPhone 




Andrea Leganza 
Laureato in Ingegneria 
Informatica, da oltre un 
decennio realizza soluzioni 
multimediali, e non, su 
piattaforme e con linguaggi 
diversi. Certificate Adobe 
ACE - Adobe Flex 3 and AIR 
Certified Expert, e EUCIP 
Core, appassionato di 
fotografia, lingua 
giapponese e istruttore di 
nuoto FIN, e attualmente 
impegnato in numerosi 
progetti multimediali, 
anche con iPhone, con 
alcune societa nazionali ed 
internazionali; e 
contattabile su 
neogene@tin.it 0 
direttamente sul sito 
www.leganza.it. 



iPhone programming 



^PuntolnformaticD I 



67 ► 



iPhone programming T 



Realizziamo un feed reader per iPhone 



UN RSS READER 
SU IPHONE 

DISTRIBUTE INFORMAZIONI ATTRAVERSO LE NOSTRE APPLICAZIONI PUO ESSERE MOLTO PIU 
SEMPLICE ADOPERANDO LA CLASSE NSXMLPARSER. SAREMO COS] IN GRADO Dl RACCOGLIERE 
E MOSTRARE I CONTENUTI DEGLI RSS CONSUMANDO POCHISSIMA BAN DA 



LJ evoluzione apportata dal web negli ultimi 
due decenni nel campo della comunica- 
( zione, ha reso possibile l'accesso a 
migliaia di fonti informative, eterogenee sia in 
termini di contenuti ma anche di presentazione 
delle informazioni. Verso la fine del millennio e 
maturata la necessita di definire un formato 
unico che consentisse l'interscambio di tali dati 
tra software e computer eterogenei ma che fosse 
anche facilmente leggibile ed analizzabile da un 
essere umano: da questa realta ha preso forma 
l'XML. 



COM E FATTO 

UN DOCUMEIUTO XML 

AlFinterno di un file XML prendono posto uno 
o piu tag, entita testuali chiamate elementi, 
delimitate dal simbolo minore (<) e maggiore 
(>) che contengono le informazioni associate 
a tale marcatore. Ogni tag pub essere del tipo 
<tag>contenuto</tag> oppure <tag />, pub 
contenere al suo interno altri tag in numero 
teoricamente illimitato, e pub inoltre avere 
dei valori associati, chiamati attributi che 
prendono posto subito dopo il nome del tag, 
prima del simbolo ">"; ecco un esempio in cui 
vengono adoperate tutte queste caratteristi- 
che: 

<?xml version = "1.0"?> 

<note> 

<nota> 

< a utore> Andrea </autore> 

<titolo>Ricordarsi di...</titolo> 



< a utore> Andrea </autore> 



<corpo>Ricordarsi di inviare una mail. 



</corpo> 



<foto url = "andrea.png" width = "160" 

height="220"/> 



</nota> 



<nota> 



<titolo>Comprare...</titolo> 



<corpo>Comprare cavo di rete 10-100- 

1000</corpo> 
<foto url = "rete.png" width = "320" 

height="480" /> 



</nota> 



<nota> 



</nota> 



</note> 

La struttura di un file XML e a discrezione 
dello sviluppatore, anche per quanto riguarda 
i nomi dei tag. E possibile impostare delle 
regole che consentono di limitare il tipo, il 
numero e i valori contenuti nei suoi elementi, 
adoperando DTD o XML Schema. La descri- 
zione qui fatta dell'XML e estremamente sem- 
plificata e le migliaia di risorse disponibili 
online comprese le decine di libri pubblicati 
rendono certamente maggiore giustizia a que- 
sto formato del W3C. Uno dei maggiori difetti 
che gli vengono attribuiti e la sua prolissita, 
che ha spinto molti sviluppatori ad optare per 
JSON (JavaScript Object Notation) . Con il pro- 
liferare di siti e blog ha preso vita il formato 
ora conosciuto come Really Simple 
Sindication, RSS, inizialmente nato con il 
nome di RDF Site Summary negli uffici di 
Netscape. L'RSS (come il suo concorrente, 
Atom) non e nient'altro che un file XML strut - 
turato con delle regole precise, il cui scopo e 
quello di organizzare e rendere fruibili alFe- 
sterno di un sito web le informazioni che ven- 
gono pubblicate al suo interno senza richie- 
dere la consultazione ripetuta delle sue pagi- 
ne. Questo formato e presente in milioni di 
siti, anche merito deirutilizzo di piattaforme 
di blogging e CMS che ne hanno automatizza- 
to la creazione, e l'icona con sfondo arancio- 
ne e righe bianche e ormai divenuta un sim- 
bolo universalmente riconosciuto per identi- 
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ficarlo. II pregio di tale formato risiede anche 
nel fatto che consente di ridurre il traffico dati 
dei siti, poiche un software che adopera RSS 
per verificare se i suoi contenuti sono stati 
aggiornati richiede un minore scambio di byte 
rispetto a quello necessario per effettuare il 
caricamento completo necessario per visua- 
lizzare interamente le pagine web (costituite 
da HTML, Javascript e immagini). A differenza 
delFXML, in RSS alcuni campi sono obbliga- 
tori e nel prossimo paragrafo avremo modo di 
approfondire questo discorso. Un aggregato- 
re, o RSS reader, e quel software che consente 
di gestire e consultare tali file RSS. In questo 
articolo e nel prossimo andremo a realizzare 
un RSS reader, adopereremo a tale scopo la 
classe NSXMLParser, presentando i titoli 
sequenzialmente in una tabella, e mostrere- 
mo i singoli contenuti in base alia selezione 
effettuata. NSXMLParser e un parser, una 
classe dedicata airanalisi di file XML, di tipo 
SAX, realizzato in Objective-C e disponibile 
airinterno dell'SDK. 



IL FILE RSS 

Ecco un esempio di come pub essere struttu- 
rato un RSS versione 2.0: 

<?xml version = "1.0"?> 
<rss version = "2.0"> 
<channel> 



<titlex/title> 

<linkx/link> 

<descriptionx/description> 



< language x/language> 
<pubDatex/pubDate> 
<lastBuildDatex/lastBuildDate> 
<item> 



<titlex/title> 

<linkx/link> 

<descriptionx/description> 
<pubDatex/pubDate> 
</item> 



</channel> 
</rss> 

Airinterno del tag rss ne e contenuto un altro 
chiamato channel, che presenta prima una 
serie di campi che descrivono le caratteristi- 
che generali del feed, come titolo, link ad una 
risorsa web, generalmente questo campo con- 
tiene il sito a cui e associato il file, trova poi 



posto la descrizione del file, la lingua, la data 
di pubblicazione, e successivamente si avran- 
no uno o piii tag item che rappresentano le 
singole notizie. Ogni item pub contenere 
diversi campi, tra cui il titolo, il link alia pagi- 
ne completa, la descrizione, la data di pubbli- 
cazione. Quelli mostrati sono sono alcuni dei 
tag disponibili, ma nessuno di questi e obbli- 
gatorio, a parte title, link e description per 
quanto riguarda la descrizione del feed, e title 
o description per il contenuto del singolo 
item. 

Consultando le specifiche relative alia versio- 
ne utilizzata e possibile realizzare un feed 
compliant con tale documentazione, avendo 
garanzia che sara accettato dalla maggior 
parte dei feed reader. 



SAX E DOM 

Quando si adopera un parser per analizzare 
un file XML/RSS, esistono principalmente 
due approcci per accedere ai suoi contenuti: 
uno e quello basato su SAX, Taltro su DOM. 
Un parser che adopera SAX, acronimo di 
Simple API for XML, si basa su un certo nume- 
ro di metodi (viene detto di tipo event-driven) 
che vengono invocati quando la libreria 
incontra determinati elementi del file XML, 
alFinterno di tali metodi e quindi cura del 
programmatore gestire i contenuti incontrati 
e memorizzarli in una struttura dati che verra 
poi mostrata airutente; Fanalisi del docu- 
mento e quindi di tipo sequenziale, partendo 
dalla radice del file giungendo fino airultimo 
ramo. 

L'approccio che adopera invece il DOM 
{Document Object Model, giunto alia versione 
chiamata "Level 3"), e del tipo tree-based, 
poiche analizza una copia completa della 
struttura del file XML, la cui struttura e 
appunto ad albero, mantenendola interamen- 
te in memoria. Un parser di tipo SAX viene 
definito streaming parser proprio per il fatto 
che attraversa e analizza la struttura in 
sequenza, e si rivela proprio per questa carat - 
teristica come la soluzione migliore quando si 
analizzano file di dimensioni relativamente 
grandi; se il proprio obiettivo e quello di non 
occupare eccessiva memoria conviene optare 
per SAX, mentre si pub scegliere indifferente- 
mente per l'uno o Faltro approccio quando si 
parsano documenti di modeste dimensioni. 
Perche allora non scegliere sempre una libre- 
ria che adopera SAX? 

In alcune situazioni e necessario avere acces- 
so airintera struttura del file immediatamen- 
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te, come awiene per il DTD, adoperato per 
validare un documento, l'XSLT, utilizzato per 
applicare trasformazioni/conversioni di 
documenti XML, e XPath, utilizzato per acce- 
dere ai contenuti delFXML, e in questi casi il 
DOM si presenta come la soluzione ideale, 
sempre a condizione di non avere strutture 
dati di dimensioni eccessive. 
Per concludere, citiamo un ultimo pregio del- 
Tapproccio SAX: nel caso ci trovassimo nella 
situazione di dover prelevare un file XML di 
medie/grandi dimensioni da una sorgente 
remota (web o intranet) per ottenere una pre- 
cisa informazione, grazie alia natura stessa di 
tale tipo di parser potremo interrompere il 
download della risorsa quando avremo rag- 
giungo il tag desiderato, cio comportera un 
risparmio di traffico che in alcuni casi potreb- 
be essere rilevante. Con Tapproccio DOM cio 
non e possibile, poiche il file deve sempre 
essere trasferito e memorizzato completa- 
mente sul computer locale prima di effettuare 
qualunque analisi. 



A COMFROIUTO 

Nonostante in questo articolo andremo ad 
utilizzare solo la classe NSXMLParser e oppor- 
tuno sapere che ne esiste un'altra, utilizzabile 
sia con SAX che DOM, realizzata in linguaggio 
C e chiamata IWXML2 fornita nelFSDK (nata 
in seno al progetto Gnome), il cui utilizzo 
pero si rivela sicuramente meno intuitivo 
rispetto alia prima, ma le cui prestazioni sono 
nettamente superiori, spesso di un ordine di 
grandezza, merito owiamente del linguaggio 
a piii basso livello che e stato utilizzato. A 
fianco di queste due soluzioni ne trovano poi 
posto altre, disponibili nel web che si propon- 
gono come un'alternativa fornendo un 
approccio solamente tramite DOM: 

• TBXML: libreria di tipo DOM con approccio 
leggero (in termini di risorse), realizzata in 
Objective-C, non effettua la validazione , 
non supporta XPath, e supporta solo la let- 
tura del file XML, non la modifica. 

• TouchXML: libreria di tipo DOM che mima 
T approccio di NSXMLParser, realizzata in 
Objective-C, supporta XPath ma come 
TBXML e solo per lettura di file XML. 

• KissXML: libreria di tipo DOM che mima 
L approccio di NSXMLParser, realizzata in 
Objective-C, basata su TouchXML, alia quale 



aggiunge la possibility di modificare TXML. 

• TinyXML: libreria realizzata in C di tipo 
DOM, supporta lettura e scrittura di file 
XML, ma non XPath, funzionalita imple- 
mentabile adoperando un'altra libreria 
associata chiamata TyinyXPath. 

• GDataXML: libreria di tipo DOM che mima 
T approccio di NSXMLParser, realizzata in 
Objective-C, sviluppata da Google, suppor- 
ta lettura e scrittura di file XML e XPath. 

Per quanto riguarda la scelta tra le due librerie 
fornite alFinterno dell'SDK, NSXMLParser e 
UhXML2, questo dipende dalle dimensioni dei 
file XML coinvolti, ma anche dalla propria 
esperienza nel linguaggio C, obbligatorio 
quando si opta per la seconda libreria; nel 
caso di indecisione si possono testare le pre- 
stazioni delle due librerie sui propri file 
XML/RSS modificando un progetto fornito 
airinterno della documentazione presente sia 
nel sito Apple che allegata in XCode, il cui 
nome e XMLPerformace, raggiungibile nella 
sezione "Related sample code" della 
NSXMLParser Class Reference. Anche se 
UbXML2 e ineguagliabile per la velocita con 
cui analizza un documento resta sempre da 
considerare la necessita di adoperare il lin- 



Carrier 



5:55 PM 



NSXMLParser (1 run): 



Mean Download Time 


4.4605s 


Mean Parse Time 


0.4183s 


Mean Total Time 


5.2248s 


Nbxm[2 (1 run): 


Mean Download Time 


0.4331s 


Mean Parse Time 


0.1972s 


Mean Total Time 


0.4400s 

j. 



Reset Statistics 




SPECIFICHEXML, 
RSS1.XE2.X 

Per mantenersi aggiornati 
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Fig. 2: Un test effetuato analizzando le top 300 songs di 
itunes mostra le differenti prestazioni delle due librerie 
fornite nell'SDK 
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LE RISORSE 
PER IPHONE 

Creazione dell'account, per 
scaricare I'SDKe 
consultare la 
documentazione: 
http://developer.apple.com/ 
iphone 



guaggio C, che per alcuni utenti si rivela lo 
scoglio maggiore. Se invece si vuole adoperare 
DOM la scelta pub cadere su qualunque delle 
cinque librerie precedentemente descritte se 
si vuole solo analizzare il documento XML, 
mentre il cerchio si restringe in caso si doves- 
se adoperare XPath oppure fosse necessario 
modificare il file. Da test empirici e risultato 
che TBXML si e rivelata una delle migliori in 
termini di velocita e di occupazione di memo- 
ria, ma per il fatto che molte librerie vengono 
modificate costantemente questa affermazio- 
ne potrebbe gia essere invalidata mentre leg- 
gete queste righe; comunque per documenti 
di dimensioni medio-grandi, quando la velo- 
cita di analisi del documento e di primaria 
importanza, il suggerimento e di adoperare 
Ubxml2 (approccio SAX), mentre conviene 
optare per TBXML per un approccio DOM, il 
cui pregio in confronto a libxml2 (approccio 
DOM) e owiamente la possibility di adoperare 
TObjective-C. Uriultima nota che potrebbe 
interessare chi desidera analizzare anche pagi- 
ne HTML con tali parser: con tutte queste 
librerie e possibile analizzare anche pagine 
web di tipo XHTML o HTML 5, poiche entram- 
bi i formati sono applicazioni dell'XML. 



IL PROGETTO 

Creiamo un nuovo progetto, di tipo "Utility 
Application", chiamandolo rssparser, modifi- 
chiamo la MainView inserendo al suo interno 
un UITableView (impostiamo delegate e data- 
source al view controller Mainviewcontroller.h 
tramite interface builder), al quale accedere- 
mo attraverso un IBOutlet inserito airinterno 
del file MainViewController.h, che chiamere- 
mo rssTable, ricondandoci sempre di invocare 
il release airinterno del metodo dealloc per 
evitare leaks. Rimuoviamo il pulsante posizio- 
nato automaticamente in basso a destra con 
l'icona "i" perche non e necessario in questo 
progetto. 

Decommentiamo il metodo viewDidLoad 
airinterno di MainviewContr oiler. c e inseria- 
mo il seguente codice: 

NSURL *thellRL = [NSURL URLWithString : @ 

"http://rss.cnn.com/rss/edition.rss"]; 

NSXMLParser *parser = [[NSXMLParser alloc] 

initWithContentsOfURL:theURL]; 

[parser setDelegate:self]; 

BOOL parseResult = [parser parse]; 



%@", parseResult?@"completato":@"errore"); 

Con queste poche righe di codice abbiamo gia 
configurato ed awiato il parser. Nella prima 
riga abbiamo creato un oggetto di tipo NSURL 
contenente il link al file RSS, nella seconda e 
stata istanziata ed inizializzata una variabile 
di NSXMLparser, successivamente abbiamo 
impostato il suo delegate alia classe corrente 
in modo da ricevere tutti gli eventi che ver- 
ranno generati dal parser durante la sua navi- 
gazione airinterno del file. Infine, invochiamo 
il metodo parse che da inizio air analisi del 
documento e mostriamo il risultato delF even- 
to nella console di debug tramite NSLog. Ora 
che abbiamo implementato il blocco di codi- 
ce responsabile deirawio del parsing apria- 
mo una parentesi sui metodi che il parser 
inviera alia nostra classe, che svolge il ruolo di 
delegate. 



IL FUniZIOniAMEIUTO 
DI NSXMLPARSER 

Utilizziamo un file XML molto semplice, con- 
tenente come informazioni la versione, un 
articolo e una descrizione associata 

<?xml version= "1.0" encoding = "UTF8"> 

<articolo autore="Andrea Leganza"> 
<titolo>Un feed reader per tutti </titolo> 
<descrizione>Articolo dedicato ai file 

XML.</descrizione> 

</articolo> 

per mostrare come si comporta un'istanza 
della classe NSXMLParser, descrivendo la 
sequenza degli eventi inviati al suo delegate, 
che deve rispettare il protocollo richiesto 
chiamato NSXMLParserDelegate: 

1. Awio del parsing del documento; 

2. Trovato inizio del tag articolo con attributo 
autore e valore "Andrea Leganza"; 

3. Trovato inizio del tag titolo; 

4. Trovati caratteri airinterno del tag titolo: 
"Un feed reader per tutti."; 

5. Trovata fine del tag titolo; 

6. Trovato inizio del tag descrizione; 

7. Trovati caratteri airinterno del tag 
descrizione: "Articolo dedicato ai file 
XML."; 

8. Trovata fine del tag descrizione; 

9. Trovata fine del tag articolo; 

10. Fine del parsing del documento. 



NSLog(@"Risultato del parsing della risorsa 



I passi 1 e 10 awengono una sola volta duran- 
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te la fase di parsing, mentre quelli di ini- 
zio/fine elemento {parser:didStartElement* e 
parser.didEnd Element") una volta per ogni 
tag incontrato; come si nota Tanalisi procede 
andando sempre piii in profonditd, per poi 
risalire quando trova i vari tag di chiusura. Se 
avessimo inserito una sequenza di n tag arti- 
colo, avremo avuto n ripetizioni della sequen- 
za dei passi da 2 a 9. Passiamo ora dalla ver- 
sione con pseudocodice alia sequenza di 
chiamate dei metodi effettivamente richiesti 
al delegate: 

1. parserDidStartDocument: 

1. parser:didStartElement:namespaceURI: 
qualifiedName:attributes: //trovato tag articolo 

1. parser:didStartElement:namespaceURI: 
qualifiedName:attributes: //trovato tag titolo 

2. parsenfoundCharacters: 

//trovato contenuto per tag titolo 

3. parser:didEndElement:namespaceURI: 

qualifiedName: //fine tag titolo 

4. parser:didStartElement:namespaceURI: 

qualifiedName:attributes: //trovato tag 
descrizione 

5. parsenfoundCharacters: 

//trovato contenuto per tag descrizione 

6. parser:didEndElement:namespaceURI: 

qualifiedName: //fine tag descrizione 

7. parserDidEndDocument: 

Oltre a questi ne esistono owiamente molti 
altri, come quelli scatenati quando il parser 
incontra caratteri particolari, tipi di informa- 
zioni non prettamente testuali {CDATA), com- 
ments o il DTD; per avere una visione com- 
pleta di tutti gli eventi che il delegate pub rice- 
vere basta consultare la documentazione rela- 
tiva a NSXMLParser Delegate. 
L'ultimo metodo che e sempre opportuno 
implementare in aggiunta ai precedenti e 
quello invocato dal parser per identificare e 
gestire le situazioni di errore, chiamato pars- 
er iparseErr or Occurred:. Un errore pub presen- 
tarsi per diversi motivi, come tag non chiusi, 
oppure caratteri non accettati, in pratica in 
tutte quelle situazioni in cui il parser e indeci- 
so sul da farsi perche ha incontrato una strut - 
tura non coerente. Airinterno del metodo 
parser:parse ErrorOccurred si pub decidere 
come procedere dopo aver interrogato 



Tistanza di NSError chiamata parseError i cui 
codici di errore sono elencati in una legenda 
presente nella sezione Parser Error Constants 
della documentazione associata alia classe 
NSXMLParser. 



IL IUUMERO 

di inivocAzionii 

La sequenza di eventi descritti nel precedente 
paragrafo per il file XML mostrato e speculare 
a quella per un file RSS owiamente con alcu- 
ne differenze in termini di numeri: in questo 
caso il numero di invocazioni di pars- 
er :didStart Element:... (e del complementare 
parser ididEndElement:...) e nettamente supe- 
riors otterremo infatti una sequenza di even- 
ti dovuta alia parte di descrizione del feed, e 
successivamente, quando il parser giungera 
alle notizie, identificate dai tag item, in nume- 
ro pari a molte decine, anche centinaia. 
Per valutare il numero complessivo di invoca- 
zioni di metodi richieste al delegate senza 
awiare il software, basandosi solo sulla strut - 
tura del file RSS, bastera calcolare il risultato 
della seguente formula: S+(K*2)+ 
(n*2)+(n*(j*2))+d dove 

• S: costante pari a 2, i due metodi di inizio e 
fine documento 

• K: costante, numero di tag utilizzati per la 
descrizione del feed; 

• n: numero di notizie (tag item) 

j: numero di tag presenti airinterno della 
singola notizia (tag item); 

• d: numero di invocazioni difoundCharacters: 

E owiamente possibile calcolare tutti questi 
parametri inserendo una variabile che conta- 
bilizzi il numero di invocazioni di ogni meto- 
do quando si awia un parsing. 
Questi calcoli possono risultare utili quando 
si e al contempo consumatore (tramite il 
software iPhone delFRSS), ma anche respon- 
sabile della sua generazione. In tal modo si 
possono apportare modifiche strutturali per 
velocizzarne Tanalisi, riducendo accapo e 
caratteri inutili, oppure semplificando la 
struttura accorpando tag ed adoperando attri- 
buti. 

Nel prossimo articolo tratteremo approfondi- 
tamente del prelievo delle informazioni airin- 
terno dei tag e mostreremo la loro descrizione 
con le informazioni associate. Buona pro- 
grammazione. 

Andrea Leganza 
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UN RSS READER 
PER IPHONE 

ADOPERANDO LA CLASSE NSXMLPARSER, POSSIAMO INTERAGIRE CON I CONTENUTI Dl 
UN FEED RSS. IN QUESTO ARTICOLO MOSTREREMO COME FARE E COME IMPLEMENTARE 
UNA STRUTTURA DATI PER LA VISUALIZZAZIONE DELLE INFO RICEVUTE 



^CD /WEB 

iPhone_RSS.rar 



Conoscenze richieste 



rr Objective-C 



Mac OS 10.5.x o 

su peri ore (10. 6.x per 

I'SDK 3.x) 



Impegno 



I _ 



Tempo di realizzazione 



0000 



NelFarticolo precedente abbiamo trattato 
in maniera teorica del parsing di feed RSS, 
descrivendo a grandi linee il formato RSS, 
cio ha permesso di mostrare come questo sia sem- 
plicemente un file XML con una precisa struttura; 
in un secondo momento sono stati descritti i due 
tipi di parser forniti nell'SDK, DOM e SAX, dei quali 
abbiamo spiegato pregi e difetti; successivamente 
siamo entrati nel vivo del corso mostrando il funzio- 
namento del parser NSXMLParser, il quale invoca 
sequenzialmente alcuni metodi che devono essere 
implementati dal suo delegate, comportamento che 
viene definito event-driven. In questa ultima parte 
mostreremo il contenuto dei metodi del delegate e 
ne spiegheremo il funzionamento. 



IL PARSING 
DEL FILE RSS 

Riproponiamo per comodita il metodo viewDidLo- 
ad nel quale diamo inizio all'operazione di parsing: 



- (void)viewDidLoad { 



//Allochiamo ed inizializziamo I'array che conterra le 

singole news; 

notizie = [[NSMutableArray alloc] init] ; 

NSURL *theURL = [NSURL URLWithString:@"http://rss. 

cn n . com/rss/edition . rss"] ; 
NSXMLParser *parser = [[NSXMLParser alloc] 

initWithContentsOfURL:theURL]; 
[parser setDelegate:self]; 
BOOL parseResult = [parser parse]; 
NSLog(@"Risultato del parsing della risorsa : %@", pars 
eResult?@"completato":@"errore"); 

} 



Spieghiamo brevemente il codice appena proposto: 
abbiamo creato un'istanza di NSURL nella quale e 
stato inserito FURL del feed che vogliamo analiz- 
zare, successivamente istanziamo un oggetto della 



classe NSXMLParser impostandone come delegate 
la classe in cui questo codice e presente; infine, 
diamo inizio all'operazione di parsing. Ora che 
abbiamo dato inizio all'operazione di parsing sap- 
piamo, dairarticolo precedente, che avremo una 
sequenza di chiamate ai seguenti metodi: 

parserDidStartDocument: (1 chiamata) 

parser: didStartElement:namespaceURI:qualifiedName: 

attributes: (n chiamate) 
parsenfoundCharacters: (m chiamate) 
parser: didEndElement:namespaceURI:qualifiedName: 

(n chiamate) 

parserDidEndDocument: (1 chiamata) 

ParserDidStartDocument e parserDidEndDocument 
indicano F inizio e il termine della procedura di par- 
sing e generalmente sono adoperati per inizializza- 
re e deallocare se necessario, tutte quelle variabili e 
strutture dati che verranno utilizzate durante la fase 
di analisi del documento RSS. parser.didStartElem 
entmamespaceURLqualifiedName: attributes: e par- 
ser:didEndElement:namespaceURI:qualiftedName: 
svolgono invece un ruolo molto importante, infatti 
ci informano quando e stato trovato un tag, aperto 
(<tag>) o chiuso (</tag>). parsenfoundCharacters: 
viene invocato quando trova del testo tra un tag 
di apertura e uno di chiusura (<tag>testo</tag>). 
parsenfoundCharacters viene invocato quando 
il parser incontra del testo alFinterno di un tag. 
AlFinterno di questi metodi dovremo popolare una 
struttura dati apposita con le informazioni ricevute 
per ogni tag, che andremo poi a inserire alFinterno 
di un array: al termine del parsing troveremo in tale 
array per ogni suo record tutti i dati associati al sin- 
golo tag incontrato. Generalmente Foperazione di 
parsing necessita delle seguenti strutture dati: 

• una istanza della classe NSMutableString, curren- 
tElement, per condividere tra le varie chiamate 
dei metodi il tag che stiamo analizzando; 

• n istanze della classe NSMutableString; nel nostro 
caso sono quattro, currentFitle, currentDate, cur- 
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rentSummary e currentLink, ognuna conterra il 
testo associato al relativo tag; 

• una istanza del tipo NSMutableDictionary, con il 
nome notizia, che conterra tutte le informazioni 
che verranno trovate per una singola news e 
associate alle NSMutableString (titolo, data, som- 
mario, link). 

• un array del tipo NSMutableArray, notizie, nel 
quale andremo ad inserire al termine del parsing 
di un tag di tipo item V NSMutableDictionary 
appena popolato; tale istanza quindi alia fine 
del parsing conterra n campi, uno per ogni news 
prensente nell'RSS. 

NSMutableArray *notizie; 
NSMutableDictionary *notizia; 
NSMutableString * currentElement; 



NSMutableString * currentTitle; 



NSMutableString * currentDate; 



NSMutableString * currentSummary; 



NSMutableString * currentLink; 

Perche adoperare istanze di NSMutableStringinve- 
ce di NSString? La flessibilita di NSMutableString 
ci consente di non dover allocare ed inizializzare 
ogni volta che troviamo un nuovo titolo, o data, 
o sommario o link, una nuova variabile, possia- 
mo infatti rimuovere la stringa che tali variabili 
contengono semplicemente impostando il loro 
testo a @"", questa operazione awerra quando 
avremo raggiunto il tag di chiusura e stiamo per 
passare ad analizzarne un altro. E importante 
ricordare che le istanze di NSString sono costanti 
e non abbiamo controllo su quando verranno 
deallocate, poiche durante il parsing ne verreb- 
bero generate centinaia, non abbiamo modo di 
sapere se e quando queste verranno rimosse dalla 
memoria, situazione invece non presente con 
NSMutableString, classe che ci consente pieno 
controllo sul suo tempo di vita grazie all'invoca- 
zione di release. Prima di iniziare con metodi che 
si rivelano sicuramente piu interessanti e impor- 
tante porre l'attenzione al caso in cui per qualche 
motivo il parser fallisca l'operazione di analisi, i 
motivi possono essere molteplici, uno dei piu fre- 
quenti puo presentarsi quando non c'e sufficiente 
copertura sulla rete GSM, oppure non e presente 
una la rete WIFI, situazioni quindi che rendono 
impossibile connettersi al server in fase di richie- 
sta della risorsa oppure in ricezione del file RSS 
se la connessione si interrompe; qualunque sia 
il tipo di errore questo interrompera il parsing, e 
nel caso in cui sia stato implementato il metodo 
parseErrorOccurred: sara responsabilita del par- 
ser prowede ad invocarlo. E sempre consigliabile 



implementare tale metodo, presentando con un 
UIAlerView la causa dell' errore, informazione 
disponibile con un codice numerico all ; interno 
del parametro parseError, in questo modo sara 
anche piu semplice ricevere segnalazioni da parte 
degli utenti in caso di un non corretto funzio- 
namento di questo componente. Per un elenco 
completo dei quasi 100 codici di errore possi- 
bili e necessario consultare la documentazione 
associata alia classe NSXMLParser, nella sezione 
chiamata Parser Error Constants. 

- (void)parser: (NSXMLParser *)parser 

parseErrorOccurred :(NSError *)parseError { 

NSLog(@"Errore di parsing: %f", [parseError code]); 

UIAIertView * errorAlertView = [[UIAIertView alloc] 
initWithTitle:@"Errore durante I'analisi " 
message: [NSString stringWithFormat:@"Errore di 

parsing: %f", [parseError code]] 

delegate:nil 



cancelButtonTitle:@"ok" 



otherButtonTitles:nil]; 



[errorAlertView show]; 



[errorAlertView release]; 



Ora bisogna ricordare quale sia la struttura piu 
comune di un file RSS: 



<?xml version="1.0"?> 



<rss version = "2. 0"> 



<channel> 



<titlex/title> 



<linkx/link> 



<descriptionx/description> 



<languagex/language> 



<pubDatex/pubDate> 



<lastBuildDatex/lastBuildDate> 



<item> 



<titlex/title> 



<linkx/link> 



description x/description> 



<pubDatex/pubDate> 



...//possibili altri parametri 



</item> 



..//ripetizioni di <item>...</item> 



</channel> 



</rss> 

Inizializziamo aH'interno del metodo parserDid- 
StartDocument prima la stringa che conterra il 
nome del tag che il parser ha incontrato, e facciamo 

10 stesso con le stringhe che conterranno i testi 
trovati alFinterno dei vari tag di ogni item; i tag che 
ci interessano sono il titolo, la data, il sommario e 

11 link alia pagina web: title, pubDate, description e 
link: 
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Fig. 1: II risultato finale 
di questo progetto 
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- (void)parserDidStartDocument:(NSXMLParser *) 



parser{ 



RIFERIMENTI WEB 

Creazione deH'account, 
per scaricare I'SDK e con- 
sultare la documentazione 
previa registrazione gratu- 
ita: http://developer.apple. 

com/iphone/ 



NSLog(@"Parsing del documento iniziata."); 
currentElement = [[NSMutableString alloc] in it] ; 
currentTitle = [[NSMutableString alloc] init] ; 
currentDate = [[NSMutableString alloc] init]; 
currentSummary = [[NSMutableString alloc] init]; 
currentLink = [[NSMutableString alloc] init]; 



} 



Deallocheremo tali variabili solo alia fine del par- 
sing, aH'interno di parserDidEndDocument: e prov- 
vederemo inline ad aggiornare la tabella che adope- 
riamo per mostrare i titoli dei feed RSS. 

- (void)parserDidEndDocument:(NSXMLParser *)parser{ 
[currentElement release]; 
[currentTitle release]; 
[currentDate release]; 
[currentSummary release]; 
[currentLink release]; 
NSLog(@"Fine del parsing."); 
NSLog(@"Notizie contiene %d elementi", [notizie 

count]); 

//Refresh dei contenuti della UITableView 
[rssTable reloadData]; 



Dopo aver inizializzato la maggior parte delle varia- 
bili necessarie per il parsing, entriamo nel vivo del 
codice, analizzando parser: didStartElement: name- 
spaceURI: qualifiedName: attributes: 

- (void)parsen(NSXMLParser *)parser 

didStartElement: (NSString *)elementNa 
me namespaceURI:(NSString *)namespa 
ceURI qualifiedName:(NSString *)qName 
attributes: (NSDictionary *)attributeDict{ 
[currentElement setString:[elementName copy]]; 
if ([currentElement isEqualToString:@"item"]) { 



do parser: foundCharacters per popolare le nostre 
NSMutableString e Y NSDictionary solo quando 
siamo alFinterno di tali tag, infatti parser: foundCha- 
racters non fornisce alcun parametro che indichi in 
che tag siamo spetta quindi a noi tenerne traccia; 
adoperiamo quindi un semplice confronto tra strin- 
ghe [elementName isEqualToString:@"tagname"]per 
capire se il tag corrente e di interesse o no. Nel caso 
in cui siamo airinterno del tag <item> prowedia- 
mo a inizializzare un NSMutableDictionary al cui 
interno inseriremo i contenuti di title, link, descrip- 
tion e pubDate. Ad una prima invocazione didStar- 
tElement: fornira come elementName @" title", alia 
seconda invocazione @" title", poi @" description" 
ed inline @" pubDate" . Un'ultima nota riguarda il 
parametro attributeDict, questo e un NSDictionary 
che contiene tutti gli attributi trovati per un tag, 
ad esempio, se il tag che abbiamo incontrato e 
del tipo <tag name-" Andrea" second="Leganza" 
age-" 31 ">Informatic Engineer er</tag> invocando su 
tale variabile il metodo objectForKey: adoperando 
come chiave il nome degli attributi presenti otterre- 
mo il valore di tali proprieta. 

[attributeDict objectForKey: @"name"]; restituisce la 

stringa @"Andrea" 
[attributeDict objectForKey: ©"second"]; restiuisce la 

stringa @"l_eganza" 
[attributeDict objectForKey: @"age"]; restiuisce la 

stringa @"31" 

Adesso che siamo all'" interno" di un tag e possono 
presentarsi due situazioni: e presente un ulteriore 
tag di apertura, come awiene per <item>, con i suoi 
tag "figli", nel qual caso verra invocata un'altra volta 
didStartElement:, oppure, come awiene quando 
siamo in uno qualsiasi dei tag "figli", verra invocato 
parser: foundCharacters: ad indicare che abbiamo 
incontrato del testo alFinterno del marcatore, del 
tipo <tag>testo_contenuto</tag>: 



notizia = [[NSMutableDictionary alloc] init]; 



} 



> 



Appena il parser ci notifica che ha trovato un tag 
di apertura, accessibile interrogando il parame- 
tro elementName, lo memorizziamo alFinterno di 
currentElement; come avevamo mostrato prima, la 
struttura di un file RSS presenta molti tag diversi, 
description, language, pubDate, lastBuildDate e tanti 
altri, a noi interessano solo i tag <item>, con i tag 
"figli" <title>, <link>, <description>, <pubDate>, che 
contengono le singole notizie, e per tale motivo pre- 
leveremo i dati dalFRSS solo quando ci troveremo 
alFinterno di tali marcatori. Ecco svelato Futilita della 
variabile currentElement, questa ci servira nel meto- 



(void)parsen(NSXMLParser *)parser 

foundCharacters: (NSString *)string{ 
if ([currentElement isEqualToString:@"title"]) { 

[currentTitle appendString:string]; 
} else if ([currentElement isEqualToString:@"link"]) { 

[currentLink appendString:string]; 
} else if ([currentElement isEqualToString:@"descripti 

on"]) { 

[currentSummary appendString:string]; 
} else if ([currentElement 

isEqualToString:@"pubDate"]) { 



[currentDate appendString: string]; 



} 



} 



Come abbiamo appena detto, currentElement ci 
permette di identificare il tag in cui ci troviamo, 
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aH ; interno di parser.foundCharacters: popoliamo la 
NSMutableString in base al tag (title,link,descriptio 
n,pubdate) che e al momento analizzato. Quando 
raggiungiamo il tag di chiusura di ogni singolo tag 
avremo un'invocazione di didEndElement, solo nel 
caso in cui abbiamo raggiunto la fine della news, 
identifcato dal tag di chiusura </item> prowediamo 
a popolare con le NSMutableString generate nel 
metodo foundCharacters V NSMutableDictionary, ini- 
zializzato nel metodo didStartElement. Concludiamo 
rimuovendo Y NSMutableDictionary e rimuovendo 
il contenuto delle NSMutableString, cosi saranno 
pronte per essere di nuovo popolate per il prossimo 
item. Ricordiamo che nel caso in cui il tag svolges- 
se il ruolo di mero contenitore di altri tag, come 
awiene per <item>, non avremo alcuna chiamata 
a foundCharacters, quindi ipotizzando che questo 
tag contenga solo i 4 tag "figli" mostrati, avremo 4 
invocazioni di foundCharacters e non 5 come alcuni 
potrebbero erroneamente pensare. 

- (void)parsen(NSXMLParser *) 

parser didEndElement: (NSString *)element 
Name namespaceURI: (NSString *)namespaceURI 
qualifiedName:(NSString *)qName{ 
if ([elementName isEqualToString:@"item"]) { 

[notizia setObject:[currentTitle copy] forKey:@"title"]; 
[notizia setObject:[currentl_ink copy] forKey:@"link"]; 
[notizia setObject:[currentSummary copy] 

forKey: ©"summary"]; 



[notizia setObject:[currentDate copy] 



forKey:@"date"]; 



[notizie addObject: [notizia copy]]; 



[notizia release]; 



[currentTitle setString:@""]; 



[currentDate setString:@""]; 



[currentSummary setString : @""] ; 



[currentLink setString :@""]; 



} 



LA POPOLAZIOHIE 
DELLA TABELLA 

Ora che abbiamo finalmente ottenuto le informazioni che 
desideriamo le andremo a mostrare in una UITableView; 
prowediamo prima a configurare la tabella: 

- (NSInteger)numberOfSectionsInTableView: 

(UITableView *)tableView { 

return 1; 

} 

- (NSInteger)tableView: (UITableView *)tableView 

numberOfRowsInSection : (NSInteger)section { 
return [notizie count]; 



popoliamo quindi il corpo del metodo responsabile 
della visualizzazione nelle singole celle/righe, table 
ViewxellForRowAtlndexPath: 

- (UITableViewCell *)tableView: (UITableView *)table 
View cellForRowAtIndexPath:(NSIndexPath *)indexPath 

{_ 

static NSString *MyIdentifier = @"MyIdentifier"; 



UITableViewCell *cell 



[tableView dequeueReusableCell 
WithIdentifier:MyIdentifier]; 



if (cell == nil) { 



cell = [[[UITableViewCell alloc] initWithStyle:UITableVie 
wCellStyleSubtitle reuseldentifier: Myldentifier] 

autorelease]; 

cell. imageView. image = [Ullmage 

imageNamed : @"news.jpg"] ; 
cell.textLabel.adjustsFontSizeToFitWidth = YES; 



} 



int notizialndex = [indexPath indexAtPosition: [index 



Path length] - 1]; 



cell. textLabel. text = [[notizie objectAtlndex: notizia 

Index] objectForKey: @"title"]; 



return cell; 



} 



A parte le tipiche operazioni di configurazione, abbia- 
mo invocato il metodo adjustsFontSizeToFitWidth 
sulla textLabel della cella alio scopo di impostare 
l'autoresizing del testo, in modo da consentire una 
completa visualizzazione del titolo della news, evitan- 
do l'autotroncamento del testo, operazione effettuata 




} 



Fig. 2: Selezionando una cella usciremo dall'applicazione e apriremo il link con Safari 
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per default da tale UILabel; otteniamo Findice della 
notizia per la relativa cella e lo memorizziamo all'in- 
terno della variabile notizialndex, andiamo quindi 
immediatamente a utilizzare nella riga successiva tale 
variabile per ottenere il relativo oggetto contenuto 
neir array notizie, e preleviamo il titolo della news uti- 
lizzando la chiave title de\Y NSDictionary selezionato. 



- (void)tableView:(UITableView *)tableView didSelect 

RowAtIndexPath:(NSIndexPath *)indexPath { 
int notizialndex = [indexPath indexAtPosition: [index 

Path length] - 1]; 

//II link viene prelevato adoperando la chiave link 

sull'NSDictionary. 
NSString *notizial_ink = [[notizie objectAtlndex: notizia 
Index] objectForKey: @"link"]; 
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LA VISUALIZZAZIOME 
DELLE PAGIIME 

Ora che abbiamo presentato correttamente a video i tito- 
li, possiamo decidere di conseguenza il modo piu adatto 
con cui rispondere alia selezione delFutente; avremmo 
potuto utilizzare una UITextView o un UlWebView ma 
approfittiamo di questo contesto per esporre una nuova 
funzionalita fornita dall'SDK: Fapertura di link web uti- 
lizzando Safari. In uno dei primi articoli dedicati alia 
programmazione su iPhone abbiamo mostrato come 
realizzare un mini web browser adoperando la classe 
UlWebView, il cui cuore e lo stesso di Safari, Fopen 
source WebKit, ma e possibile anche aprire link senza 
dover utilizzare tale classe, a patto di accettare Finconve- 
niente di dover terminare la propria applicazione. Ogni 
applicativo espone al suo interno un'istanza condivisa 
(in gergo viene chiamata un singleton) appartenente 
alia classe UIApplication, ottenibile invocando su tale 
classe il metodo sharedApplication, tale istanza fornisce 
una quindicina di metodi, due dei quali sono quelli che 
piu ci interessano in questo articolo: canOpenURL: e 
openURL:. 

II primo metodo restituisce come risultato un booleano 
(YES/NO) a seconda se il link che gli inviamo e associato 
ad almeno un software installato nel nostro telefono 
(esiste quindi almeno un software in grado di gestirne 
i contenuti), mentre il secondo prowede ad aprire tale 
link con il programma associato. Safari, il web browser 
installato di default nelF iPhone/iPod Touch, e imposta- 
to per default come software responsabile delFapertura 
dei link del tipo http://, https:// e mailto:, quindi, quan- 
do andremo a chiamare canOpenURL passando il link 
associato alia news, otterremo una risposta affermativa, 
potremo invocare openURL con la sicurezza che l'utente 
visualizzera la pagina della notizia associata all'interno 
di Safari. Immediatamente dopo Finvocazione di tale 
metodo assisteremo alia chiusura del nostro software e 
all'apertura di Safari. Questa pratica si rivela utile nei casi 
in cui non si vuole impegnare tempo nella costruzione di 
un browser web interno, ma ha il grande limite di termi- 
nare Futilizzo del software, obbligando l'utente, nel caso 
lo desiderasse, di dover riaprire il software e rieffettuare 
tutte le operazioni necessarie per mostrare nuovamen- 
te le news: e quindi una soluzione da adoperare solo 
nelle primissime fasi di sviluppo del software, succes- 
sivamente e sempre opportuno realizzare un browser 
interno, operazione che impiega in genere poche decine 
di minuti. 



//Per sicurezza vengono sostituiti, se presenti, caratteri 
non compatibili con il formato accettatto per i link con 
opportune sequenze come ad esempio %20 per rappre 

sentare lo spazio 

notiziaLink = [notiziaLink stringByAddingPercentEscapes 
UsingEncoding:NSUTF8StringEncoding]; 
//Nel caso fossero presenti simboli di ritorno a capo 

vengono rimossi 



sharedApplication consente non solo di aprire link 
a siti web, ma anche effettuare telefonate, inviare 
SMS, o anche inviare email, previa sempre confer- 
ma da parte delFutente: 

[[UIApplication sharedApplication] openURL: [NSURL URL 
WithString:@"tel://123456789"]] 

[[UIApplication sharedApplication] openURL: [NSURL URL 
WithString:@"sms://123456789"]] 

[[UIApplication sharedApplication] openURL: [NSURL URL 

WithString:@"mailto:emailAdress?subject=helloSubject& 
body=hello my friend has been a while..."]]; 

La necessita di richiedere conferma quando si effettua 
una chiamata o si invia un SMS e per evitare abusi 
da parte di sviluppatori non proprio ortodossi, che 
potrebbero effettuare chiamate senza autorizzazione 
(potendo quindi ascoltare le conversazioni altrui), 
con conseguente spesa da parte delFutente, oppure 
inviare SMS con dati sensibili senza che Futente ne 
abbia controllo; owiamente questi due metodi sono 
validi solo su iPhone e in questo caso se invocassimo 
il metodo canOpenURL su un iPod Touch otterremo 
risposta negativa. 

L'ultimo metodo, quello di invio email era una 
delle poche soluzioni disponibili prima del rilascio 
delFSDK 3, ora grazie alFintroduzione del compo- 
nente MFMailComposeViewController e sempre 
meno adoperato, e si possono applicare le stesse 
considerazioni fatte per Fapertura di link http/s con 
Safari. E anche possibile lanciare F applicativo goo- 
gle maps installato nel dispositivo http://maps.qoo- 
q I e . co m/ < parametri>) , e una pagina delFApp Store 
f http://phobos.apple.com/ <pammgfn>). E possi- 
bile inoltre registrare la propria applicazione come 
responsabile delFapertura di uno o piu formati di link 
ma e adoperato solo in rari casi. 

Andrea Leganza 
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Questo approfondimento tematico e pensato per chi vuol imparare a programmare e creare 
software per I'Apple iPhone. 

La prima parte del testo guida il lettore alia conoscenza degli strumenti necessari per 
sviluppare sulla piattaforma mobile di Cupertino. Le sezioni successive sono pensate per un 
apprendimento pratico basato su esempi di progetto: la creazione di un browser su misura, 
la gestione deH'interfaccia, la programmazione di un'agenda e di una to do list, la gestione 
corretta di celle e tabelle, I'utilizzo deH'accelerometro, la progettazione di un RSS reader e 
via dicendo. Una serie di esempi pratici da seguire passo passo che - creando applicazioni 
testabili e perfettamente funzionanti - spingono il lettore a sperimentare sul campo il proprio 
livello di apprendimento e lo invitano a imparare divertendosi. 
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